16강. stash로 작업 임시 보관

?1. 이번 강의에서 해결할 문제

기능 작업 중 긴급 수정 브랜치로 이동해야 하지만 미완성 내용을 커밋하고 싶지 않을 수 있습니다. 현재 변경을 임시 저장하고 깨끗한 작업 폴더로 전환합니다.

✓2. 학습 목표

✓이 강의를 마치면

• 추적 중인 변경과 untracked 파일을 stash합니다.
• stash 목록과 patch를 확인합니다.
• apply와 pop을 상황에 맞게 사용합니다.

◇3. 핵심 개념

stash는 작업 폴더와 stage의 변경을 저장소 내부의 임시 커밋 형태로 보관합니다. 기본 stash는 untracked 파일을 포함하지 않으므로 필요하면 -u를 사용합니다. 오래 보관할 중요한 작업은 이름 있는 브랜치와 커밋이 더 안전합니다.

§4. 단계별 명령어와 예시

실습 경로: C:\dev\git-learning-site

PowerShell

Set-Location C:\dev\git-learning-site
git status
git stash push -u -m "WIP: profile layout"
git stash list
git stash show --patch 'stash@{0}'
git switch main
git switch feature/profile-page
git stash apply 'stash@{0}'
git status
git stash drop 'stash@{0}'

PowerShell에서는 stash@{0}을 작은따옴표로 감싸 해석 충돌을 피합니다.

→5. 명령어가 동작하는 이유

stash push는 현재 변경을 별도 참조에 저장하고 작업 폴더를 기준 커밋 상태로 되돌립니다. apply는 항목을 남긴 채 재적용하고, pop은 적용 성공 후 목록에서 제거합니다. 처음에는 apply 후 검증하고 drop하는 흐름이 더 안전합니다.

!6. 자주 하는 실수와 안전한 해결법

!자주 하는 실수

• 새 파일도 자동 보관된다고 생각함: git status에서 untracked를 확인하고 필요하면 -u를 사용합니다.
• 목록 확인 없이 pop: 잘못된 stash를 적용하거나 충돌할 수 있습니다. list와 show --patch를 먼저 봅니다.
• stash를 장기 백업으로 사용: 이름 있는 브랜치에 WIP 커밋을 만들면 찾기와 공유가 쉽습니다.

✎7. 직접 실습

✎직접 실습

1. 추적 파일과 새 파일을 각각 수정·생성합니다.
2. -u -m으로 stash하고 작업 폴더가 깨끗해졌는지 확인합니다.
3. apply 후 두 파일을 검증하고 stash 항목을 명시적으로 drop합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. untracked 파일까지 보관하는 옵션은 무엇인가요?
2. apply와 pop은 stash 항목 보존 여부가 어떻게 다른가요?
3. PowerShell에서 stash@{0}을 따옴표로 감싸는 이유는 무엇인가요?

■9. 핵심 요약

■핵심 요약

stash는 짧은 브랜치 전환을 위한 임시 선반입니다. 이름을 붙이고 목록과 내용을 확인하며, 처음에는 apply로 복원 검증 후 drop합니다.