git stashでファイルを指定するには|退避対象を絞る確認手順

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ブランチの作成と切り替えを参照してください。

記事一覧へ戻る

ITの困りごとを、
まずはご相談ください。

何から手をつけるか決まっていない段階でも構いません。ご相談内容に応じて、担当者からご連絡します。

まずは相談する

採用へのご応募は採用エントリーからお願いします。