作業中のコードをコミットせずに一時的に退避させたい… そんなときに活躍するのが
git stashコマンドです。
Gitを使った開発では、「今の作業を中断して、急ぎのバグ修正に対応したい」「複数のタスクを並行して進めたい」など、状況に応じて柔軟に作業を切り替える必要が出てきます。git stash は、現在の作業状態を一時保存し、あとから元に戻せる便利なツールです。
この記事では、Git初心者にもわかりやすく git stash の基本的な使い方から、応用テクニック、トラブル対応、さらにはベストプラクティスまでを網羅的に解説します。
作業効率を高めたい方や、git stashをなんとなく使っていた方にも、確かな理解と活用のヒントをお届けします。
【チートシート】よく使うgit stashコマンド一覧
「とりあえずコマンドだけ知りたい！」という方のために、よく使う git stash コマンドをまとめました。
| やりたいこと | コマンド | 備考 |
|---|---|---|
| 作業を退避する | git stash | 変更を一時保存して作業ツリーをクリーンにする |
| メモ付きで退避する | git stash push -m "メモ" | 後から見て分かりやすいようにメッセージを残す |
| 退避した一覧を見る | git stash list | スタッシュされている作業のリストを表示する |
| 作業を戻す（消す） | git stash pop | 最新の退避を復元し、スタッシュ一覧から削除する |
| 作業を戻す（残す） | git stash apply | 最新の退避を復元するが、スタッシュ一覧には残す |
| 特定の退避を削除する | git stash drop stash@{0} | 指定したスタッシュを削除する |
| すべての退避を削除する | git stash clear | スタッシュ一覧をすべてクリアする |
はじめに：git stashって何？
git stash は、作業中の変更を一時的に保存して作業ディレクトリをクリーンな状態に戻すための Git のコマンドです。現在の変更をコミットせずに退避させることで、別のブランチでの作業や緊急対応などにスムーズに移行できるようになります。
たとえば、新しい機能を開発している途中に、緊急のバグ修正を行う必要が生じたとします。このとき、作業中の変更をそのままにしてブランチを切り替えると、競合が発生したり、未コミットの変更が混在したりして作業が煩雑になります。こうした場面で git stash を使えば、現在の作業状態を一時的に退避させておき、修正作業が終わった後に元の状態へスムーズに復元することができます。
stash された変更はスタック（積み重ね）構造で管理されており、複数の作業状態を順に退避・復元することも可能です。また、退避する際にメモをつけたり、未追跡ファイルも含めたりといった柔軟な操作もできます。
Git を使った日々の開発作業において、git stash は単なる一時避難所ではなく、タスクの切り替えや作業の整理をスムーズに進めるための強力な武器になります。本記事では、その基本から応用までを丁寧に解説していきます。
【目的別】git stashの基本コマンド一覧
git stash の基本操作を、目的別に詳しく解説します。
作業中の変更を退避する
最もシンプルな使い方は以下のコマンドです。
git stashこのコマンドを実行すると、ステージングされていない変更（作業ツリーの変更）と、ステージング済みの変更（インデックスの状態）がまとめて退避され、作業ディレクトリはクリーンな状態になります。
より明示的な書き方としては、以下のようにメモ付きで保存することもできます。
git stash push -m "新機能の途中"-m オプションを使うことで、どんな作業をstashしたのかをあとで見返しやすくなります。
退避した作業の一覧・中身を確認する方法
stashされた変更の一覧は、以下のコマンドで確認できます。
git stash list出力例：
stash@{0}: On main: 新機能の途中
stash@{1}: On main: バグ修正前の状態それぞれ stash@{0}、stash@{1} のように番号が割り振られ、スタックとして管理されています。数字が小さいほど新しいスタッシュです。
中身の差分を詳しく見たい場合は、git stash show -p を使います。
git stash show -p stash@{0}退避した作業を戻す（復元する）方法
stashした内容を再び作業ディレクトリに戻すには apply か pop を使います。この2つの違いを理解しておくことが重要です。
① スタッシュを残したまま戻す（apply）
git stash apply stash@{0}このコマンドは内容を復元しますが、stash自体は削除されず一覧に残ります。適用後にコンフリクトが起きた場合でも、スタッシュが残っているため安全です。
② スタッシュを削除しつつ戻す（pop）
git stash pop stash@{0}適用と同時にstashのスタックからも削除されます。「もうこのスタッシュは不要だ」と確信できる場合に使います。
退避した作業を削除する
作業を終えたあとに不要になったstashを手動で削除する場合は、次のようにします。
git stash drop stash@{0}すべてのstashを一括で削除するには、以下のコマンドを使用します。
git stash clear新しいブランチを作って復元する
退避した内容を新しいブランチとして切り出したい場合には、以下のように stash branch を使うと便利です。
git stash branch fix-bug stash@{0}この操作により、指定したstashを反映した新しいブランチが作成され、元の変更を引き継いで作業を続けることができます。
使用例で理解するgit stashの活用シーン
git stash は、単なる一時退避ツールにとどまらず、実際の開発現場で非常に役立つ場面が多くあります。ここでは、具体的なシナリオを挙げながら、どのような場面で git stash を使うと便利なのかを解説します。
急なバグ修正の対応
開発中に突然、リリース済みのバージョンに関するバグ修正依頼が来ることがあります。現在の作業はコミット前で中断したくない、しかし一旦対応しなければならない。そんなときに git stash を使えば、作業中の状態を保存しておいて別のブランチに切り替えることができます。
git stash push -m "作業中の機能A"
git checkout release-branch
# バグ修正を行う修正が完了した後、元の作業に戻り、stashを復元するだけでOKです。
git checkout feature-A
git stash pop複数タスクを並行して進めたいとき
複数の開発タスクを並行して進める場合、それぞれのブランチを切り替えるたびに変更内容をどう扱うかが課題になります。git stash を使えば、作業ごとに一時保存しておけるため、ブランチの切り替えが柔軟になります。
git stash push -m "機能A：画面の見た目調整"
git checkout feature-Bタスクごとに適切なタイミングで stash pop や apply を使って変更を戻すことで、作業の混在やミスを防げます。
作業を一時的に保留したいとき
「ちょっと席を外す」「会議に呼ばれた」「一旦別のことをやらなきゃ」など、開発中に一時中断せざるを得ないシーンもよくあります。そんなとき、ステージングせずに手軽に保存できる git stash は非常に便利です。
git stash push -m "途中経過"変更を失う心配なく中断できることで、安心して作業に戻ることができます。
特定のファイルだけ退避・復元したい場合の応用テクニック
基本的な git stash の使い方をマスターしたら、さらに細かく柔軟に操作できる応用テクニックも覚えておくと便利です。ここでは、特定ファイルだけをstashに含めたり、部分的に復元したりする方法を紹介します。
未追跡ファイルもstashする（-u / –include-untracked）
デフォルトでは、git stash は未追跡ファイル（git add していない新規作成ファイル）を含めません。これらも一緒に退避したい場合は、以下のように -u オプションを使います。
git stash push -uインタラクティブに変更を選んでstashする（–patch）
すべての変更を一括でstashするのではなく、「この変更はstashしたいけど、これは残しておきたい」といった細かい制御が必要なこともあります。そんなときに使えるのが --patch（または -p）オプションです。
git stash push -pこのコマンドを実行すると、変更内容ごとに「stashするかどうか」を確認するプロンプトが表示され、細かく選択できます。
特定ファイルだけ復元する（Git 2.23以降）
stashされた変更のうち、特定のファイルだけを元に戻したい場合には git restore コマンドを使うと便利です。
git restore -s stash@{0} -- path/to/fileこの方法では、stashの中にある指定ファイルだけを選んで復元できるため、大きな変更の一部だけを戻したいときに重宝します。
トラブルシューティングと注意点
スタッシュを適用したらコンフリクト（競合）が起きた
git stash apply や pop を実行した際、スタッシュ内の変更と現在の作業ディレクトリの内容に差異があると、競合（コンフリクト）が発生することがあります。
対処法：
- コンフリクトのあったファイルを確認（Gitが自動でマーキングします）
- エディタで手動で修正し、
git addでステージング - 必要に応じて
git commitで確定
もし「やっぱりスタッシュの適用をやめたい」という場合は、以下のコマンドで作業ツリーをリセットできます（ただし、スタッシュ適用前の未コミットの変更も消えるので注意してください）。
git reset --hard HEADgit stash pop のあとに内容が消えた
git stash pop は適用後にスタッシュを削除します。もし適用に失敗したり、競合中に操作を誤ると、変更内容が失われる可能性があります。
安全策：内容を残しておきたいときは、apply を使って、適用後に手動で drop する方が安全です。
git stash apply stash@{0}
# 問題なく適用されたことを確認してから
git stash drop stash@{0}間違って stash drop や clear を実行してしまった
drop や clear を実行すると、スタッシュは即座に削除され、基本的には元に戻せません。ただし、Gitの内部履歴を使って一部の情報を取り戻せる可能性があります。
対処法（上級者向け）：
git fsck --lost-foundまたは
git reflogを使って、該当するオブジェクトハッシュを探し、そこから手動で内容を復元することができる場合があります。
stash が増えすぎて管理しづらい
git stash list を確認すると、過去の作業が大量に残っていて、どれが必要か分からなくなることがあります。
対処法：
push -mでメモを残す習慣をつける- 古いスタッシュを定期的に
dropかclearで整理する - 必要な内容はなるべく早めに
applyしてブランチにコミットしておく
git stashを使う際のベストプラクティス
- スタッシュには必ずメモをつける
-mオプションを使って何の作業か分かるようにしましょう。 - 一時的な用途にとどめる
スタッシュは短期的な一時保管が目的です。中長期の作業管理はブランチ運用に切り替えるのが安全です。 - applyとpopの違いを理解して使い分ける
安全に復元したい場合はapplyを使いましょう。 - 未追跡ファイルを含めるかどうか意識する
新規作成ファイルがある場合は-uオプションを忘れないようにしましょう。 - ブランチを分けた方が良い場合は早めに切り替える
ある程度まとまった作業内容になっているなら、git stash branchを使って新しいブランチに切り出しましょう。
まとめ：git stashは正しく使えば強力な作業効率化ツール
git stash は、作業中の変更を一時的に退避させることで、タスクの切り替えや緊急対応をスムーズにしてくれる非常に便利なコマンドです。
本記事では、以下のようなポイントを解説しました。
- よく使うコマンドのチートシート
git stashの基本的な使い方（push、apply、pop、list、drop など）- 実践的なユースケース（作業中断、複数タスク並行、緊急対応など）
- 応用テクニック（一部変更のみを退避、ファイル単位での復元）
- よくあるトラブルとその回避法
git stash は「ちょっとした保留」や「すぐ戻したい作業」を安全に管理できる、開発者にとっての心強い味方です。使い方をしっかり理解すれば、作業効率が大きく向上し、安心してブランチを切り替えたりタスクを並行したりできるようになります。
今後はぜひ、単なる「緊急退避」のためだけでなく、意図的に活用するツールとして git stash を使ってみてください。作業の柔軟性とスピードが格段に上がるはずです。
コメント