1. 導入：なぜgit cleanが必要なのか
開発中に「コードは正しいはずなのに、なぜかビルドが通らない」「古い生成物が邪魔をして意図しない挙動になる」といった経験はありませんか？Gitで`git reset –hard`を実行しても、Git管理下にない「未追跡ファイル（Untracked files）」は削除されず、そのまま残ってしまいます。これらの不要なファイルが原因で発生するトラブルを解決し、作業ディレクトリをGitの最新の状態と完全に一致させるために、`git clean`コマンドは欠かせないツールです。
2. 基礎知識：未追跡ファイル（Untracked files）とは
Gitにおいて、一度も`git add`されたことがないファイルやディレクトリを「未追跡ファイル」と呼びます。これには、コンパイル時に生成される実行ファイル、依存関係ライブラリのキャッシュ、ログファイル、あるいは誤って作成してしまったテストファイルなどが含まれます。Gitはこれらを管理対象外としているため、コミット履歴を巻き戻す操作（reset）をしても、これらのファイルは消えずに残ります。
3. 実装：安全かつ確実に掃除する手順
`git clean`は強力なコマンドであるため、誤って必要なファイルを削除しないよう、以下のステップで進めるのが鉄則です。
まず、ドライラン（実行シミュレーション）で削除対象を確認します。
コマンド：`git clean -nd`
次に、問題なければ実際に削除を実行します。
コマンド：`git clean -fd`
各オプションの意味は以下の通りです。
・-n: 実際に削除せず、対象となるファイルを表示する（Dry-run）
・-f: 実際に削除を実行する（Force）
・-d: ディレクトリも対象に含める
4. サンプルプログラム：クリーンアップ用シェルスクリプト
以下のスクリプトは、作業ディレクトリを完全にクリーンな状態にするためによく使われる構成です。コピー＆ペーストして、プロジェクトのルートディレクトリで実行してください。
!/bin/bash
1. まずは管理下にある変更を全て破棄して最新のコミット状態に戻す
git reset –hard HEAD
2. 未追跡のファイルとディレクトリを削除する（-f:強制、-d:ディレクトリ含む）
もし無視リスト（.gitignore）に含まれるファイルも消したい場合は -x を追加してください
git clean -fd
echo “作業ディレクトリがクリーンになりました。”
5. 応用・注意点：現場でのトラブル回避
現場で活用する上で、以下の点に注意してください。
・.gitignoreの活用: 消したくない設定ファイルや環境変数ファイル（.envなど）は、必ず`.gitignore`に記述してください。`git clean`は`.gitignore`に記載されているファイルを自動的に除外してくれます。
・-xオプションの危険性: `git clean -fdx`とすると、`.gitignore`で除外されているファイル（ビルド済みバイナリなど）も全て削除されます。完全に初期状態に戻したい場合は便利ですが、再インストールや再ビルドに時間がかかる可能性があるため注意が必要です。
・削除前の確認: 重要な作業ファイルを作業ディレクトリ直下に置く癖がある人は要注意です。`git clean`を実行する前に、必ず`git status`で未追跡ファイルの中に残すべきものがないか目視確認する習慣をつけましょう。
コメント