git stashの削除は、作業ツリーのファイルを消す操作ではなく、退避しておいた記録を一覧から除く操作です。不要になった記録を整理する前に、どの変更を保存したものか、ほかに必要な保存先があるかを確認します。
ここではdropとclearの範囲を整理し、記録を識別してから削除する流れを示します。コマンドは未実行の説明例です。
dropは一件、clearは一覧全体を対象にする
Gitの公式資料では、dropは一つの退避記録を、clearはすべての退避記録を削除します。削除した記録は後に回収対象となり、復元できなくなる可能性があります。
| 操作 | 対象 | 先に確かめること |
|---|---|---|
| drop | 指定した一件 | その記録が本当に不要か |
| clear | 一覧のすべて | すべて不要と判断できるか |
一件だけを消したい場面で、一覧を空にする操作を使わないようにします。削除後の復旧を前提にして整理を進めることも避けます。
番号を覚えたまま削除しない
退避一覧のstash@{0}は最新の記録です。新たに退避したり別の記録を削除したりすると、番号と内容の対応が変わり得ます。削除する直前に一覧を読み直します。
git stash list
git stash show -u --stat 'stash@{1}'
作業名だけで内容を断定せず、対象ファイルや必要な差分も確認します。特に未追跡ファイルを含めて退避した記録は、それらがほかに残っているかを確認してください。
必要な変更を先に確定する
削除を判断するための例として、次の三つを確認します。
- 元の作業は完了したか、中止したか。
- 残す変更は確認済みのコミットなどへ保存されているか。
- 退避記録にしか存在しない新規ファイルがないか。
この確認はGitが自動的に保証するものではなく、作業を保全するための判断項目です。復元した変更をまだ確認していないなら、記録を残したまま確認を終える方法もあります。
対象を一件ずつ確認する
不要と確認した記録だけを指定する例です。
git stash drop 'stash@{1}'
git stash list
処理後は一覧を再確認し、予定した記録が除かれ、残す記録があるかを見ます。連続して複数件を整理するときも、最初の番号表を使い回さず、その時点の一覧に合わせます。
一時保存を積み上げたままにしない
記録の名前・作業の状態・必要な保存先を対応させると、削除の判断を説明しやすくなります。長く残す作業は一時退避だけに頼らず、共有の必要や機密情報の扱いも含めて保管方法を決めましょう。変更を作業単位に分ける考え方はGitのブランチ運用も参考になります。