git stash는 무엇이며 언제 사용하나요?

Question

Accepted Answer

**git stash**는 commit하지 않은 변경 사항을 일시적으로 **저장**하고 작업 디렉터리를 깨끗한 상태로 되돌립니다. 따라서 절반만 끝낸 작업을 commit하지 않고 컨텍스트를 전환할 수 있고(예: 다른 branch에서 긴급 버그 수정), 나중에 변경 사항을 복원할 수 있습니다.

## stash가 해결하는 문제

```text
commit하지 않은 변경 사항이 있는 작업 중인데 긴급하게 컨텍스트를 전환해야 함:
  → branch 전환? Git이 거부하거나(commit하지 않은 변경이 충돌) 지저분하게 끌고 감
  → 절반만 끝낸 작업을 commit? 아니오 — 준비되지 않음(히스토리 오염)
→ STASH는 변경 사항을 옆에 저장하여, 전환할 깨끗한 작업 디렉터리를 제공.
```

## stash 사용하기

```bash
git stash                      # commit하지 않은 변경 저장; 작업 디렉터리가 깨끗해짐
git stash push -m "message"    # 설명과 함께 stash
git stash list                 # stash 목록(stash@{0}, stash@{1}, ...)

git stash pop                  # 최신 stash 복원하고 목록에서 제거
git stash apply                # 복원하되 목록에 유지
git stash apply stash@{1}      # 특정 stash 적용
git stash drop stash@{0}       # stash 삭제
git stash clear                # 모든 stash 제거
```

`git stash`는 변경 사항을 저장하고 작업 디렉터리를 깨끗하게 합니다. `git stash pop`은 나중에 복원합니다(그리고 stash 제거). `apply`는 제거 없이 복원합니다.

## 일반적인 시나리오

```bash
# 기능 작업 중이지만 main에서 긴급 버그를 수정해야 함:
git stash                      # 진행 중인 기능 작업 저장
git switch main
# ... 긴급 버그 수정, commit, push ...
git switch feature
git stash pop                  # 기능 작업 복원하고 계속
```

## 유용한 옵션

```text
git stash -u        → 추적되지 않은(UNTRACKED) 파일도 stash(추적된 변경만 아님)
git stash show -p   → stash에 무엇이 있는지 확인
→ stash는 일시적 저장용 — 장기적으로 commit/branch를 대체하는 것은 아님.
```

## 왜 중요한가

`git stash`를 이해하는 것은 흔한 실제 상황인 **컨텍스트 전환을 깔끔하게 처리하는 데** 가치 있으므로, 유용한 실무 Git 지식입니다.

stash가 해결하는 문제는 빈번합니다. commit하지 않은 변경 사항이 있는 작업 중에 긴급하게 **컨텍스트를 전환**해야 할 때(다른 branch에서 프로덕션 버그 수정, 다른 사람의 코드 리뷰, 업데이트 pull)인데, commit하지 않은 변경 사항으로 branch를 전환하는 것은 문제가 있고(Git이 거부하거나 지저분하게 끌고 감) 절반만 끝낸 작업을 commit하면 히스토리가 오염됩니다. **stash**는 이를 우아하게 해결합니다. **변경 사항을 옆에 저장**하여 컨텍스트를 전환할 깨끗한 작업 디렉터리를 제공하고, 돌아왔을 때 **나중에 복원**합니다. 이는 "잠시 지금 하던 것을 내려놓아야 한다"는 흔한 시나리오에 정확히 들어맞습니다.

핵심 명령어(저장하는 `git stash`, 복원하고 제거하는 `git stash pop`, 복원하고 유지하는 `git stash apply`, stash를 보는 `git stash list`)와 일반적인 워크플로(진행 중인 작업을 stash하고, 전환하여 긴급 작업을 처리한 다음, 다시 전환하여 pop)를 이해하는 것은 중단을 관리하기 위한 일상의 실무 지식입니다.

유용한 옵션(추적되지 않은 파일을 포함하는 `-u`, stash 내용 보기)과 stash가 **일시적** 저장용(commit/branch의 장기적 대체가 아님)이라는 점을 아는 것은 올바른 사용을 반영합니다.

컨텍스트 전환과 중단은 개발에서 흔하고(긴급 버그, 리뷰, 깨끗한 작업 디렉터리 필요), stash는 commit하지 않은 작업을 일시적으로 옆에 두었다가 나중에 복원하는 깔끔하고 편리한 방법을 제공하므로, `git stash`를 이해하는 것 — 무엇을 해결하는지, 명령어, 일반적인 컨텍스트 전환 워크플로 — 은 끝나지 않은 작업을 commit하지 않고 컨텍스트를 전환해야 하는 빈번한 실제 필요를 처리하기 위한 가치 있고 실무적으로 관련된 Git 지식입니다. 이는 매일 개발의 흔한 중단을 매끄럽게 하는 편리한 도구입니다.