git stash applyは退避した変更を適用し、退避記録を一覧に残します。popは適用に成功するとその記録を一覧から除きます。ただし、競合が起きたpopでは記録が残るため、成功時と同じつもりで次の操作を進めないことが大切です。
この記事では、復元方法の選択と競合時の確認を整理します。コマンドは仕様に基づく未実行の説明例です。
復元後に記録を残すかで選ぶ
Gitの公式説明では、applyはpopと同様に変更を適用しますが、退避状態を一覧から削除しません。
| 操作 | 適用成功時 | 競合が起きたとき |
|---|---|---|
| apply | 記録を残す | 状態を確認し、競合を解消する |
| pop | 対象記録を一覧から除く | 対象記録は一覧に残る |
復元した内容を確認してから削除したい場合は、applyで適用し、確認後に対象の記録を整理する流れが考えられます。これは安全確認のための進め方で、applyなら競合しないという意味ではありません。
現在の作業と対象記録を確認する
復元前に現在の作業ツリーと、適用したい退避記録を確認します。
git status --short
git stash list
git stash show --stat 'stash@{0}'
別作業の未コミット変更がある場合は、混ぜてよいかを先に判断します。適用先のブランチ名だけでなく、退避時からどのような変更が入ったかも確認してください。
applyで戻した後は差分を読む
対象を確認したうえで適用する例です。
git stash apply 'stash@{0}'
git status --short
git diff --stat
「コマンドが終わった」と「意図した作業状態になった」を分けて確かめます。対象ファイル、ステージ状態、動作確認の結果を見てからコミットや記録削除へ進みます。
--indexは作業ツリーだけでなくindexの状態も戻そうとする指定ですが、競合などにより失敗する場合があります。ステージ状態の復元を必要とする場合だけ条件を確認して使います。
popで競合したら同じ操作を繰り返さない
公式資料では、popの適用が競合で失敗した場合、退避記録を一覧から削除しないと説明されています。競合は人が内容を確認して解消し、その後に必要ならdropで記録を整理します。
ここでpopを連続実行しても、どの変更を残すかという判断は済みません。まずgit statusで競合ファイルを特定し、各ファイルの必要な内容を決めます。競合を戻したい場合も、元からあった未コミット変更を失う操作を安易に使わないでください。
残った記録と復元結果を対応させる
適用・確認・記録削除を別の判断として扱うと、競合後に記録を二重適用する混乱を減らせます。復元後の差分と必要なテストを確認し、退避一覧も見直して作業を終えます。競合を読む基本はGitのマージと競合確認も参考になります。