$Git Simulator
壊しても大丈夫。全部ブラウザの中だけで動いています

レッスン一覧 › 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 status

Saved working directory and index state WIP on feature/menu と表示され、working tree clean になります。変更は消えたのではなく、stash という棚 に保管されています。

git stash list

STEP 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 で履歴を整える