[Git] git stash 현재 작업 임시 저장하기

 

특정 브랜치에서 작업을 하던 중 다른 요청으로 하던 작업을 멈추고 다른 브랜치로 변경해야 하는 상황이 왔다. 

그냥 변경하려고 하니 오류가 발생하였다. 

error: Your local changes to the following files would be overwritten by checkout:
				...
Please commit your changes or stash them before you switch branches.
Aborting

아직 마무리하지 않은 작업을 스택에 잠시 저장할 수 있도록 하는 명령어인 git stash를 사용하여 해결할 수 있었다.

 git stash를 사용하여 아직 완료하지 않은 일을 commit 하지 않고 나중에 다시 꺼내와 마무리할 수 있다.

 

01. git stash란?

Git에서 git stash는 현재 작업 중인 변경 사항을 임시로 저장해 두고, 작업 디렉터리를 깨끗하게 비울 수 있게 하는 명령어이다.

이후에 저장해 둔 변경 사항을 다시 적용할 수 있다. 주로 브랜치를 변경하거나 긴급한 버그 수정을 해야 할 때 유용하다.

• git stash 명령을 사용하면 워킹 디렉토리에서 수정한 파일들만 저장한다.
• stash란 아래에 해당하는 파일들을 보관해두는 장소이다.
  • Modified이면서 Tracked 상태인 파일
    • Tracked 상태인 파일을 수정한 경우
    • Tracked: 과거에 이미 commit하여 스냅샷에 넣어진 관리 대상 상태의 파일
  • Staging Area에 있는 파일(Staged 상태의 파일)
    • git add 명령을 실행한 경우
    • Staged 상태로 만들려면 git add 명령을 실행해야 한다.
    • git add는 파일을 새로 추적할 때도 사용하고 수정한 파일을 Staged 상태로 만들 때도 사용한다.

 

02. 주요 명령어

변경 사항 임시 저장

git stash

 

저장된 변경 사항 목록 확인

git stash list

 

저장된 변경 사항 적용

git stash apply

 

저장된 특정 변경 사항 적용

git stash apply stash@{index}

 

저장된 변경 사항 삭제

git stash drop

 

저장과 동시에 브랜치 전환

git stash push -m "작업 설명"
git checkout 다른_브랜치

 

저장된 변경 사항 적용 후 삭제

git stash pop

 

03. git stash 사용

stash로 특정 파일만 임시저장후에 stash 목록 보기

git stash push -m "description" 경로

ex) git stash push -m "두개 파일 임시 저장" /src/one.tsx  /src/two.tsx
ex) git stash push -m "src 하위 파일 한번에 저장하기" /src/*

git stash list

 

 

stash 적용하기(이전에 했던 작업을 다시 가져오기)

// 가장 최근의 stash를 가져와 적용한다.
$ git stash apply

// stash 이름(ex. stash@{2})에 해당하는 stash를 적용한다.
$ git stash apply [stash 이름]

 

위의 명령어를 통해 했던 이전에 저장했던 작업을 다시 가져온다.

 

수정했던 파일들을 복원할 때 반드시 stash 했을 때와 같은 브랜치일 필요는 없다.

만약 다른 작업 중이던 브랜치에 이전의 작업들을 추가했을 때 충돌이 있으면 알려준다.

 

stash 제거하기

apply 옵션은 단순히 stash를 적용하는 것으로, 해당 stash는 스택에 여전히 남아있다.

스택에 남아 있는 stash는 아래 명령어을 사용 하여 제거할 수 있다.

// 가장 최근의 stash를 제거한다.
$ git stash drop

// stash 이름(ex. stash@{2})에 해당하는 stash를 제거한다.
$ git stash drop [stash 이름]

 

stash 되돌리기

실수로 잘못 stash 적용한 것을 되돌리고 싶으면 위의 명령어를 이용한다.

// 가장 최근의 stash를 사용하여 패치를 만들고 그것을 거꾸로 적용한다.
$ git stash show -p | git apply -R

// stash 이름(ex. stash@{2})에 해당하는 stash를 이용하여 거꾸로 적용한다.
$ git stash show -p [stash 이름] | git apply -R

 

TIP. alias

alias로 편리하게 사용하자. stash-unapply라는 명령어를 등록하여 간단하게 사용할 수 있다.

$ git config --global alias.stash-unapply '!git stash show -p | git apply -R'
$ git stash apply
$ #... work work work

// alias로 등록한 stash 되돌리기 명령어
$ git stash-unapply

 

04. vscode ui로 사용하기

우측 source control 탭으로 이동하여 ... 버튼을 눌러준다. stash 메뉴에서 원하는 메뉴를 선택하면 된다. 

stage에 올라간 변경사항을 stash 해보자.  

 

view stash 메뉴를 클릭하면 아래와 같이 저장해둔 변경 사항을 확인할 수 있다. 

 

적용과 동시에 스택에서 해당 stash를 제거하기 위해 pop stash 메뉴를 사용해 보자

 

pop 할 stash 목록을 선택한다. 

 

이전에 저장해 둔 작업 사항을 다시 가지고 나온 것을 확인할 수 있다.