レッスン一覧 › Lesson 11
作業を一時退避する(stash)
作業の途中で別のブランチに移らなければならない時。コミットせずに変更を棚に上げる stash を学びます。
難易度: 基本 ・ 所要時間: 約 8 分 ・ 学ぶコマンド: stash / switch
このページはブラウザ上のターミナルで実際にコマンドを打ちながら進めるレッスンです(JavaScript を有効にしてください)。手順は次のとおりです。
STEP 1: 作業の途中で割り込みが入る
feature/menu ブランチで作業を始めます。
git switch feature/menu
echo "// メニュー機能(作りかけ)" >> app.js
git statusここで「main に緊急の修正を入れてほしい」と頼まれました。でも app.js は書きかけで、コミットできる状態ではありません。
試しに main に移動してみましょう。
git switch mainこのケースでは移動できてしまいます(app.js は main でも同じ内容なので、変更を持ったまま移動できる)。しかし一般には would be overwritten エラーで止められることも多く、どちらにしても 作りかけの変更が main に紛れ込むのは危険 です。
STEP 2: stash で棚に上げる
feature/menu に戻って(もし main に移動していたら)、変更を stash に退避します。
git switch feature/menu
git stash
git statusSaved working directory and index state WIP on feature/menu と表示され、working tree clean になります。変更は消えたのではなく、stash という棚 に保管されています。
git stash listSTEP 3: 緊急修正をする
きれいな状態になったので、main で修正してコミットします。
git switch main
echo " line-height: 1.6;" >> style.css
git commit -am "緊急修正: 行間を調整"STEP 4: 作業を戻す(stash pop)
feature/menu に戻って、棚から変更を取り出します。
git switch feature/menu
git stash pop
git status
cat app.js「メニュー機能(作りかけ)」の行が戻ってきました。pop は「取り出して棚から消す」です。棚に残しておきたいときは git stash apply を使います。
まとめ
stash の使い方
| コマンド | 意味 |
|---|---|
git stash | 変更を退避してワークツリーをきれいにする |
git stash list | 退避したものの一覧 |
git stash pop | 最新の退避を戻して棚から消す |
git stash apply | 戻すが棚には残す |
git stash drop | 棚から消す |
git stash -m "メモ" | 名前を付けて退避 |
stash は便利ですが、長く放置すると「これ何だっけ」になりがちです。一時的な避難場所 として使い、すぐに戻すか、コミットに変えましょう。
実は、作りかけでも「WIP: メニュー機能」としてブランチにコミットしてしまい、あとで
git commit --amendやreset --softで整える方法もよく使われます。stash とコミット、どちらでも構いません。
次のレッスン: rebase で履歴を整える