git stashで一部のファイルだけを退避するときは、pushの後に対象のパスを指定します。別の作業の変更が混在している場合、退避するパスと残すパスを先に決めることが重要です。
この記事ではファイル単位の指定を扱います。同じファイルの一部分だけを選ぶ操作とは分けて考えます。コマンドは未実行の説明例です。
pushとpathspecで対象を絞る
Gitの公式仕様では、pathspecに一致するファイルの変更を退避し、そのファイルのindexと作業ツリーをHEADの状態へ戻します。一致しないファイルはそのまま残ります。
git stash push -m 'payment-form-work' -- src/payment.js tests/payment.test.js
--はオプションとパスの境界を明示します。ファイル名は仮のものなので、そのまま実行せず自分の変更一覧と照合してください。
退避する変更と残す変更を先に分ける
仮に決済画面と検索画面を同時に修正しているなら、次のような小さな表で対象を分けられます。
| ファイル | 今回の扱い | 理由 |
|---|---|---|
| src/payment.js | 退避 | 中断する決済画面の作業 |
| tests/payment.test.js | 退避 | 同じ変更を確認するテスト |
| src/search.js | 残す | 継続する検索画面の作業 |
依存する設定や共通部品の変更があるなら、それも同じ作業に必要かを確認します。ファイル名で分けられても、変更内容が独立しているとは限りません。
未追跡ファイルを含めるか確認する
新規作成したテストなど、まだ追跡していないファイルは通常のstashだけでは対象になりません。含める必要があるときは-uの意味を確認し、対象パスと組み合わせます。無視対象の扱いはさらに別です。
git status --short
git stash push -u -m 'payment-form-work' -- src/payment.js tests/payment.test.js
追加のファイルが残っていないか、退避後にも状態を見直します。退避の成否だけでなく、続ける作業に必要なファイルが残っているかが確認点です。
作成後は記録と作業ツリーの両方を見る
git stash list
git stash show -u --stat 'stash@{0}'
git status --short
記録側では退避対象を、作業ツリー側では残す変更を見ます。この二方向の確認で、意図せず別作業まで退避していないかを確かめます。
旧形式のgit stash saveはpathspecを受け取る方式ではなく、公式資料ではpushの利用が案内されています。ファイル名をsaveの引数へ足すだけで対象指定になると考えないでください。
ファイル単位で分けられない場合は立ち止まる
同じファイルの中に複数目的の修正が混ざっているときは、ファイル指定だけでは目的別に分割できません。差分を小さく整理する、作業用のコミットへまとめるなど、残したい単位から方法を選びます。
退避するものだけでなく、残るものも説明できる状態にすることが大切です。作業開始時の分け方はGitブランチの作成と切り替えを参照してください。