Git stash 쓰다가 작업 코드 날려먹는 개발자들의 공통 실수

조회수 3회
Fieldlog

수정 중인 파일을 잠시 치워야 할 때 Git stash를 사용할 수 있습니다. 작업 트리와 인덱스의 변경을 저장해 두고 해당 변경을 HEAD 상태로 되돌리는 기능입니다. 핵심은 저장 범위를 먼저 정하고, 복원 결과를 확인한 다음 보관 항목을 지우는 것입니다.

1. 작업을 보관하기 전에 저장 범위를 정하기

기본 stash는 수정된 tracked 파일과 staged 변경을 보관합니다. 새로 만든 untracked 파일은 기본 대상에 포함되지 않습니다. 따라서 새 파일까지 함께 치워야 한다면 -u 옵션을 선택해야 합니다.

글자나 기호 없이 책상 위 작업 재료를 작은 보관함에 정리하는 정사각형 일러스트

메시지를 붙여 구분하기

git stash push -m "검색 화면 수정 중"
git stash list

push -m은 보관 항목에 설명을 붙입니다. 인자 없이 실행하는 git stash도 push와 같지만, 작업을 다시 찾기 쉽도록 설명을 붙이는 방식을 권합니다.

선택 저장 범위와 주의점
기본 tracked 파일의 수정과 staged 변경을 저장합니다. untracked 파일은 제외됩니다.
-u 기본 범위에 untracked 파일을 추가합니다. ignored 파일은 포함하지 않습니다.
-a ignored 파일까지 포함합니다. 저장 후 작업 트리에서 정리하므로 범위를 신중히 선택합니다.

새 파일까지 포함하려면 첫 번째 명령을, ignored 파일까지 포함하려면 두 번째 명령을 선택합니다. 두 명령을 연속 실행하는 예시는 아닙니다.

git stash push -u -m "새 파일 포함"
git stash push -a -m "무시 파일 포함"

-u와 -a는 추가 대상 파일을 저장한 뒤 작업 트리에서 정리합니다. 새 파일을 보관하려고 -u를 썼다고 해서 ignored 파일까지 저장되는 것은 아닙니다.

2. 목록과 변경 내용을 보고 복원하기

git stash list로 항목을 찾고 git stash show로 내용을 확인합니다. stash@{0}은 최신 항목입니다. 아래 예시는 최신 항목이 복원하려는 작업인지 확인한 뒤 적용하는 흐름입니다.

글자나 기호 없이 열린 보관함 속 작업 재료를 살펴보는 정사각형 일러스트
git stash list
git stash show -p 'stash@{0}'
git stash apply 'stash@{0}'

show는 기본적으로 변경 통계를 보여주며, 기본 표시 방식은 설정의 영향을 받을 수 있습니다. 예시처럼 -p를 지정하면 패치 내용을 확인할 수 있습니다. apply는 변경을 적용하면서 보관 항목을 목록에 남깁니다.

staged 상태도 되살리고 싶다면

일반 apply만으로 저장 당시의 staged 상태가 자동 복원되는 것은 아닙니다. 인덱스 상태까지 복원하려면 위의 일반 apply 대신 다음 명령을 선택할 수 있습니다.

git stash apply --index 'stash@{0}'

--index는 인덱스 상태 복원도 시도하는 옵션입니다. 충돌 때문에 실패할 수 있으므로, 성공을 가정하지 말고 파일 내용과 staged 상태를 확인해야 합니다. pop에서도 이 옵션을 사용할 수 있습니다.

3. 충돌을 해결하고 확인한 항목만 정리하기

git stash pop은 적용이 성공하면 항목을 제거합니다. 반면 충돌이 생기면 보관 항목을 유지합니다. 충돌이 났을 때 같은 항목을 다시 pop하는 절차로 진행하지 말고, 먼저 충돌을 수동으로 해결하고 변경 결과를 검토합니다.

글자나 기호 없이 보관함에서 꺼낸 작업 재료를 책상 위에 다시 배치하는 정사각형 일러스트

보관 항목을 남긴 채 결과 검토하기

실무 팁: 메시지를 붙여 저장하고, list와 show -p로 대상 내용을 확인한 뒤 apply로 복원해 보세요. 파일 내용과 필요한 staged 상태를 검토한 다음 해당 항목만 drop하면 복원 중에도 보관 항목이 남습니다. 이는 공식 명령의 동작을 조합한 권장 흐름이며 Git이 요구하는 필수 절차는 아닙니다.

검토를 마쳤다면 다시 목록을 확인합니다. 새 항목을 저장하거나 기존 항목을 삭제했다면 처음 확인한 번호를 그대로 믿지 말고, 지울 항목을 다시 골라 내용을 확인합니다.

git stash list
git stash show -p 'stash@{0}'
git stash drop 'stash@{0}'

이 예시의 마지막 명령은 최신 항목이 검토를 마친 바로 그 항목일 때만 실행합니다. 다른 항목을 정리할 때는 목록에서 확인한 참조로 바꿉니다. drop은 특정 항목을, clear는 전체 항목을 제거합니다. 삭제 후에는 복구가 불가능할 수 있으므로 결과 확인 전에 정리하지 않습니다.

자주 묻는 질문

새 파일이 작업 폴더에 남아 있는 이유는 무엇인가요?

기본 stash에서 untracked 파일은 제외되기 때문입니다. untracked 파일도 보관하려면 git stash push -u를 사용합니다. ignored 파일까지 포함해야 하는 상황에는 -a가 필요합니다.

다른 브랜치에도 적용할 수 있나요?

다른 브랜치에도 적용을 시도할 수 있습니다. 다만 현재 변경과 맞지 않으면 충돌이 생길 수 있으므로, 같은 브랜치에서 저장했다는 이유만으로 또는 다른 브랜치가 아니라는 이유만으로 충돌이 없다고 가정하지 않습니다.

pop이 충돌했는데 항목이 남아 있어도 괜찮나요?

충돌 시 항목이 유지되는 것은 문서에 명시된 동작입니다. 충돌을 수동 해결하고 결과를 확인한 뒤, 더 이상 필요하지 않은 해당 항목을 drop으로 정리합니다.

apply와 pop 중 무엇을 선택하면 되나요?

적용 후에도 보관 항목을 유지하며 검토하려면 apply를 선택할 수 있습니다. pop은 적용 성공 시 항목까지 제거하므로 두 명령의 정리 시점 차이를 기준으로 선택합니다.

참고한 공식 문서: Git stash 매뉴얼, Pro Git의 Stashing and Cleaning.

댓글 남기기