git stash 실무 가이드: 작업 임시 저장, pop 충돌 복구, 안전한 사용 순서

git stash 실무 가이드: 작업 임시 저장, pop 충돌 복구, 안전한 사용 순서

git stash는 미완성 변경을 임시 저장해 브랜치 전환이나 긴급 수정에 대응할 때 매우 유용하다. 다만 pop 충돌과 누락 파일 처리 규칙을 알아야 안전하다. 초보~중급 개발자가 바로 적용할 수 있도록 명령어 흐름, 옵션 선택 기준, 복구 절차를 실무 중심으로 설명한다.

공식 Git 로고 (출처: git-scm.com)

git stash 기본 사용 패턴

git stash push -u -m "wip: checkout timeout fix"
git switch main
git stash list
git stash pop

자주 쓰는 옵션 3~6개

항목	의미	언제 쓰는지(실무 상황)
push -m	메시지와 함께 stash 생성	여러 임시 작업을 구분해 관리할 때
-u	untracked 파일 포함 저장	신규 파일까지 함께 보관해야 할 때
list	stash 목록 확인	복구할 항목을 선택할 때
apply	stash 유지한 채 적용	여러 브랜치에서 동일 변경을 시험할 때
pop	적용 후 stash 삭제	한 번만 복원하고 끝낼 때

실무 적용 순서

1) 실행 전 상태 확인

git status와 git log로 현재 위치를 확인한다. 특히 원격 공유 브랜치인지, 로컬 전용 브랜치인지 먼저 판단해야 안전하다.

2) 목적에 맞는 옵션 선택

동일 명령어라도 옵션에 따라 이력 보존, 충돌 위험, 협업 영향이 달라진다. 팀 정책과 배포 단계에 맞춰 옵션을 고른다.

3) 실행 후 검증

명령 실행 뒤에는 status, diff, 테스트를 통해 결과를 검증한다. 필요하면 즉시 복구 명령(reflog, revert, stash)을 연계한다.

문제 상황 1개

상황: stash pop 후 충돌이 발생해 작업이 꼬였다.
원인: 대상 브랜치 코드가 stash 생성 시점과 달라졌다.
해결: 충돌 파일을 해결하고 테스트 후 커밋한다. 필요하면 pop 대신 apply로 재시도한다.
예방 팁: 오래된 stash는 주기적으로 정리하고 메시지를 명확히 남긴다.

참고/출처

공식 문서: git-stash manual
공식 문서: Pro Git - Stashing and Cleaning
신뢰 자료: Atlassian - git stash