Git作業中に中断せざるを得ない場面で、未完成の変更をコミットせずに「一時保存」したいことがあります。その際に活躍するのがstash機能です。作業効率を高めるために、stashでの**使い方をしっかり理解し**、どのコマンドをどんな場面で使うかを知っておくとプロジェクト管理が格段に楽になります。この記事ではGit stash 使い方 一時保存にフォーカスして、詳細かつ実践的に解説します。
目次
Git stash 使い方 一時保存の基本概念
Git stash 使い方 一時保存は、現在の作業中の変更を一時的に退避させ、作業ツリーをクリーンな状態に戻す仕組みを指します。変更をコミットしたくない未完の作業や複数の作業を並行したい場合に便利です。stash はスタック構造で管理され、最新のものが最初に復元されます。具体的には追跡ファイルの変更やステージ済みの変更を退避し、それによりブランチ切替や緊急の修正が簡単になります。
stashの「一時保存」とは何か
stash の「一時保存」とは、現在のワーキングツリー（作業対象フォルダ内）の変更内容を Git の管理外のスタックに退避させることを意味します。追跡対象になっているファイルの変更・ステージ済みの内容などを保存し、HEADに戻してワーキングツリーをきれいにできます。これはコミットせずに作業を中断したいときに用いられます。
stashが含むもの・含まないもの
デフォルトでは追跡されたファイルの変更（ステージ済み・未ステージ両方）が stash の対象です。それ以外に、未追跡ファイルや .gitignore に無視されているファイルは対象外です。ただし、オプションを使うことで未追跡ファイルや無視ファイルも含めることが可能であり、必要に応じて細かく制御できます。
stashのスタック構造と識別
stash は最新の保存が stash@{0}、その前が stash@{1} といった形式でインデックス付けされます。複数保存するとスタックが増えていき、一覧表示でどの stash がどの内容か見分けやすくするためにメッセージを付与することもできます。適宜 list して状態を確認する癖をつけると安全性が高まります。
Git stash の具体的な使い方とコマンド例
実際に Git stash を使う方法を順序立てて見ていきます。コマンドの働きやオプションを理解し、状況に応じて適切な操作を選べるようになります。最新情報をもとに、追跡対象／未追跡ファイルの扱いやステージの状態なども含めて解説します。
変更の保存（stash push / stash）
作業中の変更を一時保存するには git stash または git stash push を使います。後者では -m メッセージ付きで保存でき、どの stash が何を保存しているか明確になるので多数の stash を扱うときに便利です。デフォルトでは追跡対象ファイルの変更とステージ済み内容が対象です。
未追跡ファイルも含めたい場合は -u オプション、すべて（無視対象含む）なら -a を付けます。部分的に保存したいファイルだけ指定したりステージ済みの変更を保持したまま保存するオプションもあるため、細かくコントロール可能です。
保存した変更の一覧表示と内容確認
git stash list で保存されている stash の一覧を見られます。各エントリーにはインデックス番号とブランチ名、メッセージが表示され、stash@{0} が最新です。どの stash を適用するか決める際に便利です。
また git stash show を使うと差分の概要が確認でき、 git stash show -p を使えば具体的な差分パッチとして内容をチェックできます。これによりどの stash を復元すべきか判断できます。
stash の適用と復元（pop・apply）
stash を復元する代表的な方法に git stash pop と git stash apply があります。両者は復元対象の変更内容をワーキングツリーに再適用する点で共通ですが、その後のスタックからの削除の扱いが異なります。状況に応じて使い分けることが作業効率を左右します。
pop と apply の違い
git stash pop は変更を復元した後にその stash エントリーを削除します（ただし復元が衝突なしに成功した場合）。一方、git stash apply は復元のみで stash エントリーは残るため、他ブランチで使いたい場合や保険として残しておきたい場合に適しています。
特定の stash を指定して復元する方法と –index オプション
最新の stash でなく stash@{1} や stash@{2} のように特定のエントリーを指定して pop または apply できます。さらに –index オプションを使うと、ステージ済み状態も保存時のまま復元でき、ステージが戻るため再構築の作業が不要になります。ただし、適用先のワーキングツリーが index と HEAD の状態と大きく異なると衝突が起こることがあります。
Git stash 使い方 一時保存の応用テクニック
基本をマスターしたら、stash を使った高度な手法も取り入れたいところです。チームでの作業や複数のタスクを並行する際、効率化や安全性の向上に役立つテクニックが役立ちます。ここでは実際に使われる応用例を紹介します。
部分的に一時保存する（パッチ単位で保存）
変更内容の一部だけを stash したい場面では git stash push -p を使います。このオプションを利用すると対話形式でどの変更を保存するか選べます。大きなファイルや多数のファイルを扱うとき、重要な部分だけを優先して保存できるのでレビューや緊急タスク切替がスムーズになります。
未追跡ファイル・無視ファイルを含める方法
新しく追加されたけれど git add されていないファイル（未追跡ファイル）は、デフォルトでは stash に含まれません。これらも保存したいときは -u オプションを使い、さらに .gitignore に無視されているファイルまで含めるには -a を使います。プロジェクトによっては多用されるので慎重に扱うのがポイントです。
新しいブランチを stash から作成して作業を続ける
stash を保存した後、今の状態を元に別のブランチで作業を続けたいときには git stash branch を使います。stash を作成した時点のベースコミットから新しいブランチをチェックアウトし、保存した変更を復元します。衝突を避けるためにとても便利な方法です。
stash の削除と管理：drop と clear
stash が不要になったら git stash drop を使って特定のエントリーを削除できます。古いものや途中で使わなくなった stash を整理することでスタックが雑然としないようにできます。また stash を全て消したいときには git stash clear があり、これによりスタックがすべてリセットされます。ただし取り消しは難しいため慎重に使う必要があります。
Git stash を使う際のトラブルと回避策
stash の便利さがゆえに、使い方を誤るとデータが失われたり作業効率が下がったりします。ここではよくある問題とその解決策を詳しく見ておきます。適切な備えで安心して stash を活用できるようになります。
衝突が起きたときの処理
stash の適用時に現在のブランチやワーキングツリーと食い違いがあると衝突が起きます。pop や apply のどちらでも衝突の際は手動で conflict マーカーを解消し git add でステージし、必要なら git stash drop を行います。pop が成功する前には stash が削除されないので安全性があります。
誤って stash を drop してしまった場合の復旧方法
特定の stash を誤って drop したり clear してしまった場合、Git の内部で未参照のコミットとして残っている可能性があります。git fsck –unreachable を使って unreachable オブジェクトを探し、WIP メッセージを手がかりにして復元可能です。ただしガーベジコレクションによって消えてしまうこともあるため早めの対応が望ましいです。
stash を共有できないことの誤解
stash はローカルリポジトリにのみ存在し、リモートには push や fetch によって送られません。チームで共有すべき作業内容は一時的なブランチを作成して push するか、stash をパッチとして export するなどの方法を使うとよいです。これを理解していないと変更が他メンバーに見えず混乱の元になります。
大きな stash スタックでの識別の混乱
stash を頻繁に使うとスタックが溜まり、どれがどの内容か分からなくなることがあります。そのときは stash を作成する際にメッセージをつけること、list 時に内容を show で確認すること、不要になったものを drop／clear で整理する習慣をつけることが効果的です。
Git stash 使い方 一時保存による作業効率化のコツ
stash を単に使えるだけでなく、**作業効率を最大限に引き出す使い方**を身につけると一味違います。ここでは日常的によくあるワークフローでのコツをいくつか紹介します。ちょっとした工夫が作業の流れを滑らかにします。
適切なタイミングで stash を使う
新しいタスクに着手する前、あるいは重要な修正依頼が出たときなど、作業中断の可能性がある場面で stash を使うとストレスが減ります。中途半端にコミットしてしまうと履歴が乱れることがありますから、stash を使って“きれいな状態”を保つことが大切です。
stash を使ったブランチ切り替えの活用
異なるタスクやバグ修正に移るとき、stash を使えば安心してブランチを切り替えることができます。例えば main ブランチに緊急修正を加える必要がある場面で、現在の作業を stash してから main に移動・修正・再度元のブランチに戻って stash を pop するなどが典型的な使い方です。
stash の命名とログ管理
stash を保存する際に -m メッセージを付けることが非常に重要です。何を途中で中断したか、どの機能に関するものかなどを簡潔に書いておくと、多数 stash があるときに目的のものを見つけやすくなります。list と show を組み合わせて確認する習慣をつけましょう。
apply と pop を状況で使い分ける
apply は複数のブランチで同じ変更を検証したいときや、保険として stash を残しておきたいときに選びます。pop は“これで終わり”という確信がある場面で使うとスタックをすっきり保てます。pop が成功する条件などを理解しておくと安全に使えます。
まとめ
Git stash 使い方 一時保存をしっかり理解すると、未完成の作業を安全に保ちながらブランチ切り替えや緊急対応がスムーズになります。stash の基本概念、どのコマンドが何をするか、どのようなオプションがあるか、トラブル時の対処法などを押さえておくと安心です。
特に今日から実践できるポイントとしては次のとおりです。
- stash を使う前に何を保存したいか明確にすること
- stash push -m で分かりやすいメッセージをつけること
- apply と pop の差異を理解し目的に応じて使い分けること
- 不要な stash を drop や clear で整理すること
これらを日々の作業に取り入れることで、作業フローがクリアになり、ミスが減るはずです。Git stash を味方にしてください。
コメント