스태시 생성
현재 워크트리의 변경사항을 임시저장합니다.1
스태시 버튼 클릭
우측 사이드바 툴바의 스태시 버튼을 누릅니다. 워킹 카피(Working copy)가 깨끗하면(변경 없음) 버튼은 비활성 상태입니다.
2
메시지와 옵션 설정
스태시 모달에서 옵션을 정합니다.
- 메시지 (선택) — 나중에 알아보기 쉽도록 설명을 적어 둡니다.
- Staged 변경 유지 (—keep-index) — 켜면 스태시를 만든 뒤에도 인덱스에 올려 둔(staged) 변경이 워킹 카피에 그대로 남습니다. 일부만 커밋하려고 스테이징을 마친 상태에서, 나머지를 치워 두고 스테이징한 것만 빌드·테스트할 때 사용합니다.
- Untracked 파일 포함 (-u) — 아직 추적되지 않는 새 파일도 함께 저장합니다.
3
스태시할 파일 선택
메시지 입력칸과 옵션 토글 사이에 있는 Stash할 파일(Files to stash) 목록에는 staged·unstaged 변경 파일이 체크박스로 나열되고, 기본적으로 전부 선택되어 있습니다. 체크를 해제하면 그 파일은 워킹 카피에 남고 선택한 파일만 스태시됩니다(부분 스태시). 스태시할 변경이 하나도 없으면 이 목록 자체가 나타나지 않습니다.
- 이름이 바뀐 파일은
이전이름 → 새이름형태로 한 항목으로 표시됩니다. 이 항목을 선택하면 이전 경로의 삭제와 새 경로의 추가가 함께 스태시되어, 반쪽만 옮겨진 상태가 남지 않습니다. - Untracked 파일 포함 (-u) 토글을 끄면 untracked 파일은 목록에서 사라져 선택 대상이 아니게 되고, 다시 켜면 목록에 되돌아옵니다.
- 전부 선택된 상태라면 경로를 지정하지 않는 일반 스태시로 실행됩니다.
4
스태시 실행
스태시 버튼을 누르면 모달이 닫히고 진행·결과가 토스트로 표시됩니다. 완료되면 선택한 파일이 워킹 카피에서 사라지고 그래프가 갱신됩니다. 전부 스태시했다면 워킹 카피가 깨끗해집니다.
파일 목록에서 모든 체크를 해제하면 스태시 버튼이 비활성화됩니다. 그 밖의 이유로 실제 저장할 변경이 없을 때도 빈 스태시가 만들어지지 않고, “저장할 변경이 없습니다”에 해당하는 오류로 안내됩니다.
스태시 적용
저장해 둔 변경을 다시 작업 트리로 불러옵니다.1
스태시 선택
좌측 저장소 패널의 스태시 섹션에서 적용할 항목을 우클릭해 **스태시 적용(Apply stash)**을 고르면 적용 모달이 열립니다.
2
적용 후 삭제 여부 결정
적용 후 스태시 삭제 옵션으로, 적용에 성공하면 목록에서 지울지 남길지 정합니다. 옵션 아래에 충돌 시 유지됨 안내가 붙어 있듯, 충돌이 발생하면 스태시는 삭제되지 않고 안전하게 유지됩니다(해결 방법은 아래 참고).
3
적용 실행
적용 버튼을 누르면 모달이 닫히고 진행·결과가 토스트로 표시됩니다. 완료되면 변경이 작업 트리에 복원됩니다.
적용 중 충돌이 났을 때
충돌한 파일은 워킹 카피 패널의 충돌 파일 섹션에 모입니다. 파일을 클릭하면 병합 에디터가 열리고, 한쪽 고르기·직접 편집 등 해결 방법은 병합 충돌 해결과 같습니다.다만 스태시 적용 충돌은 특수한 경우입니다.
git stash apply/pop은 MERGE_HEAD 같은 “진행 중” 상태를 남기지 않으므로 상단의 충돌 배너도, 계속하기·중단 흐름도 없습니다. 충돌을 해결해 스테이지에 올린 뒤 평소처럼 커밋하면 되고, 되돌리려면 변경을 폐기하면 됩니다. 스태시는 삭제되지 않고 목록에 남아 있으니 다시 적용할 수 있습니다.스태시 삭제
더 이상 필요 없는 스태시를 제거합니다. 좌측 저장소 패널의 스태시 항목을 우클릭해 삭제를 고르면 삭제 모달이 열리고,stash@{N}: <메시지>를 확인한 뒤 삭제를 누르면 해당 스태시가 목록에서 사라집니다.
그래프에서 스태시 보기
스태시는 목록뿐 아니라 커밋 그래프에도 노드로 표시됩니다.- 스태시를 만든 시점의 base 커밋에서 갈라져 나온 별도 노드로 그려지고, base 커밋 바로 위에 놓입니다.
- 노드는 점선 원으로, base로 향하는 연결선도 점선으로 그려져 정규 히스토리가 아님을 나타냅니다.
- 행에는 아카이브 아이콘이 붙고, 제목은
stash@{N}: <메시지>형태로 표시됩니다.
좌측 스태시 목록에서 항목을 한 번 클릭하면 그래프의 해당 스태시 노드로 스크롤·선택됩니다. 스태시 노드를 선택하면 우측 사이드바에 그 스태시의 정보와 담긴 변경 파일 목록이 표시되며, 파일을 고르면 diff가 열립니다.