git stash — 書きかけを退避する

stash で退避してブランチを乗り換える

1. checkout の回の続きです。main で todo.txt に書きかけの1行があります。

   $ echo "チーズを買う" >> todo.txt

2. feature に移ると書きかけが上書きされるので、checkout は止まります。まだコミットするほどではない書きかけを、どうするかです。

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

3. git stash は、書きかけの変更を 退避の棚 にしまい、作業ツリーとステージを HEAD のコミットの中身に戻します。右下の棚に1つ入りました。WIP on main は「main で作業中だったもの」という意味です。

   $ git stash
   Saved working directory and index state WIP on main: 71d9b3e バターを追加

4. 作業ツリーがきれいになりました。書きかけは消えたのではなく、棚にしまってあります。

   $ git status
   On branch main
   nothing to commit, working tree clean

5. 今度は乗り換えられます。退避の棚はブランチとは別の場所なので、乗り換えても棚の中身はそのままです。

   $ git checkout feature
   Switched to branch 'feature'

6. feature での用事を済ませます。

   $ echo "ジャムを買う" >> todo.txt

7. feature が1つ進みました。

   $ git commit -am "ジャムを追加"
   [feature bee85e4] ジャムを追加
    1 file changed, 1 insertion(+)

8. main に戻ります。作業ツリーは「バターを追加」の中身で、まだ書きかけはありません。

   $ git checkout main
   Switched to branch 'main'

9. git stash pop で、棚の一番上の書きかけを作業ツリーに戻します。戻したら、その退避は棚から消えます（Dropped）。

   $ git stash pop
   On branch main
   Changes not staged for commit:
     (use "git add <file>..." to update what will be committed)
     (use "git restore <file>..." to discard changes in working directory)
   	modified:   todo.txt
   
   no changes added to commit (use "git add" and/or "git commit -a")
   Dropped refs/stash@{0} (2cb140787ab31c261e146db1c3475be5ef684c18)

10. 「チーズを買う」が戻ってきました。退避した main に戻ってから pop したので、ぶつかるものはありません。

    $ cat todo.txt
    牛乳を買う
    卵を買う
    パンを買う
    バターを買う
    チーズを買う

名前を付けて退避する — list・apply・drop・pop

1. 書きかけを2つ、別々に退避してみます。まず todo.txt に1行足します。

   $ echo "チーズを買う" >> todo.txt

2. -m で退避に名前を付けられます。git stash push は git stash と同じ意味で、-m などのオプションを付けるときに使う形です。

   $ git stash push -m "チーズの件"
   Saved working directory and index state On main: チーズの件

3. 続けて、今度は notes.txt に1行足します。

   $ echo "10時に出る" >> notes.txt

4. push を省いて git stash -m と書いても同じです。棚に2つ積まれました。

   $ git stash -m "時間の件"
   Saved working directory and index state On main: 時間の件

5. git stash list で棚の中身が出ます。stash@{0} が一番新しい 退避で、古いものほど番号が大きくなります。

   $ git stash list
   stash@{0}: On main: 時間の件
   stash@{1}: On main: チーズの件

6. apply は、番号で選んだ退避を作業ツリーに戻します。ただし 棚には残したまま です。

   $ git stash apply stash@{1}
   On branch main
   Changes not staged for commit:
     (use "git add <file>..." to update what will be committed)
     (use "git restore <file>..." to discard changes in working directory)
   	modified:   todo.txt
   
   no changes added to commit (use "git add" and/or "git commit -a")

7. 「チーズの件」はまだ棚にあります。戻した中身と棚の中身が、両方ある状態です。

   $ git stash list
   stash@{0}: On main: 時間の件
   stash@{1}: On main: チーズの件

8. 戻したチーズはコミットしました。

   $ git commit -am "チーズを追加"
   [main aac69a0] チーズを追加
    1 file changed, 1 insertion(+)

9. もう要らない「チーズの件」は drop で棚から捨てます。drop は退避を作業ツリーに戻さずに捨てます。ここではコミット済みなので困りませんが、まだ戻していない退避を drop すると、その書きかけは失われます。

   $ git stash drop stash@{1}
   Dropped refs/stash@{1} (595a4542ef99496d2b0a7d2d91081b825f0064fa)

10. 残った「時間の件」を pop で戻します。番号を省くと stash@{0} が対象です。pop は「apply して drop する」と同じです。

    $ git stash pop
    On branch main
    Changes not staged for commit:
      (use "git add <file>..." to update what will be committed)
      (use "git restore <file>..." to discard changes in working directory)
    	modified:   notes.txt
    
    no changes added to commit (use "git add" and/or "git commit -a")
    Dropped refs/stash@{0} (45a6ff6951e3a8413a7569273def0e24e62f5d63)

11. 棚が空になったので、もう一度 pop すると No stash entries found. で止まります。

    $ git stash pop
    No stash entries found.

stash が退避しないもの・戻さないもの

1. todo.txt に1行足します。

   $ echo "パンを買う" >> todo.txt

2. これは add して、ステージにも入れておきます。

   $ git add todo.txt

3. もう1つ、新しいファイル memo.txt を作ります。こちらは一度も add していない、追跡していないファイル です。

   $ echo "レシピを見る" > memo.txt

4. 退避します。棚に入ったのは todo.txt の変更だけです。

   $ git stash
   Saved working directory and index state WIP on main: 8b41d07 卵を追加

5. memo.txt は Untracked files に残ったままです。git stash は、追跡していないファイルを退避しません。作業ツリーがきれいになったように見えて、実は残っています。

   $ git status
   On branch main
   Untracked files:
     (use "git add <file>..." to include in what will be committed)
   	memo.txt
   
   nothing added to commit but untracked files present (use "git add" to track)

6. 戻します。todo.txt は Changes not staged for commit に出ました。退避する前は add してあったのに、ステージには戻らず、作業ツリーの変更として戻る のが既定の動きです。

   $ git stash pop
   On branch main
   Changes not staged for commit:
     (use "git add <file>..." to update what will be committed)
     (use "git restore <file>..." to discard changes in working directory)
   	modified:   todo.txt
   
   Untracked files:
     (use "git add <file>..." to include in what will be committed)
   	memo.txt
   
   no changes added to commit (use "git add" and/or "git commit -a")
   Dropped refs/stash@{0} (1542b74d0ecb707c2476eb32c3c970b71655db9a)

7. ステージに入れたいときは、もう一度 add します。

   $ git add todo.txt

8. 退避する前と同じ状態に戻りました。

   $ git status
   On branch main
   Changes to be committed:
     (use "git restore --staged <file>..." to unstage)
   	modified:   todo.txt
   
   Untracked files:
     (use "git add <file>..." to include in what will be committed)
   	memo.txt