git stashを削除する前に|一覧・差分と残す記録の確認

git stashの削除は、作業ツリーのファイルを消す操作ではなく、退避しておいた記録を一覧から除く操作です。不要になった記録を整理する前に、どの変更を保存したものか、ほかに必要な保存先があるかを確認します。

ここではdropとclearの範囲を整理し、記録を識別してから削除する流れを示します。コマンドは未実行の説明例です。

dropは一件、clearは一覧全体を対象にする

Gitの公式資料では、dropは一つの退避記録を、clearはすべての退避記録を削除します。削除した記録は後に回収対象となり、復元できなくなる可能性があります。

操作 対象 先に確かめること
drop 指定した一件 その記録が本当に不要か
clear 一覧のすべて すべて不要と判断できるか

一件だけを消したい場面で、一覧を空にする操作を使わないようにします。削除後の復旧を前提にして整理を進めることも避けます。

番号を覚えたまま削除しない

退避一覧のstash@{0}は最新の記録です。新たに退避したり別の記録を削除したりすると、番号と内容の対応が変わり得ます。削除する直前に一覧を読み直します。

git stash list
git stash show -u --stat 'stash@{1}'

作業名だけで内容を断定せず、対象ファイルや必要な差分も確認します。特に未追跡ファイルを含めて退避した記録は、それらがほかに残っているかを確認してください。

必要な変更を先に確定する

削除を判断するための例として、次の三つを確認します。

  1. 元の作業は完了したか、中止したか。
  2. 残す変更は確認済みのコミットなどへ保存されているか。
  3. 退避記録にしか存在しない新規ファイルがないか。

この確認はGitが自動的に保証するものではなく、作業を保全するための判断項目です。復元した変更をまだ確認していないなら、記録を残したまま確認を終える方法もあります。

対象を一件ずつ確認する

不要と確認した記録だけを指定する例です。

git stash drop 'stash@{1}'
git stash list

処理後は一覧を再確認し、予定した記録が除かれ、残す記録があるかを見ます。連続して複数件を整理するときも、最初の番号表を使い回さず、その時点の一覧に合わせます。

一時保存を積み上げたままにしない

記録の名前・作業の状態・必要な保存先を対応させると、削除の判断を説明しやすくなります。長く残す作業は一時退避だけに頼らず、共有の必要や機密情報の扱いも含めて保管方法を決めましょう。変更を作業単位に分ける考え方はGitのブランチ運用も参考になります。

記事一覧へ戻る

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

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

まずは相談する

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