投稿

[GitHub 100日チャレンジ] Day 65 - git cleanで作業ツリーを整理する

untracked fileを削除するgit cleanの使い方と、dry-runで安全に確認してから整理する手順を学びます。

[GitHub 100日チャレンジ] Day 65 - git cleanで作業ツリーを整理する

git cleanとは

git cleanは、Gitが追跡していないファイルを作業ディレクトリから削除する命令です。

1
2
3
git status --short
# ?? debug.log
# ?? dist/

??で表示されるファイルやディレクトリが対象になります。

まずdry-runする

いきなり削除せず、まず -n で何が消えるか確認します。

1
2
git clean -n
git clean -nd

削除前に、一覧に残しておきたいファイルがないか確認します。実行するのは確認済みの範囲だけです。ディレクトリを含めるなら -nd と -fd を組み合わせます。git clean 公式ドキュメント

1
2
git clean -f
git clean -fd

ignoredファイルも消す場合

.gitignoreに入っているファイルも含めて消すなら -x を使います。

1
2
3
git clean -ndx -- dist/
# dist/ の内容を確認してから実行
git clean -fdx -- dist/

-x をリポジトリ全体に使うと、ローカルの .env も削除されることがあります。例ではビルド先の dist/ に範囲を絞っています。

よく使う順番

1
2
3
git status --short
git clean -nd
git clean -fd

git restore . はステージ済みの内容を基準に作業ファイルを戻します。未追跡のファイルを削除する場合は git clean を使います。

今日のゴール

git cleanは未追跡ファイルを片付ける道具です。必ずdry-runで確認してから削除する習慣をつけましょう。

この投稿は投稿者によって CC BY 4.0 の下でライセンスされています。