1. 導入：なぜgit clean -nが必要なのか
開発中にビルド生成物や一時ファイルが溜まり、「リポジトリを一度スッキリさせたい」と思うことはよくあります。そんな時に使うのが `git clean` コマンドですが、このコマンドは非常に強力で、一度実行するとファイルを復旧できません。誤って必要な設定ファイルや開発中のコードを消してしまう事故を防ぐために、実行前に「何が消えるかを確認する」という安全策が不可欠です。それが今回紹介する `git clean -n` です。
2. 基礎知識：git cleanとは何か
`git clean` は、Gitの管理下にない「未追跡ファイル（Untracked files）」を削除するためのコマンドです。
- 未追跡ファイルとは: 新規作成したけれど `git add` していないファイルや、ビルドプロセスで生成されたログ、実行ファイルなどのことです。
- なぜ削除するのか: 開発環境をクリーンな状態に保つことで、ビルドエラーの防止や、余計なファイルがコミットされるリスクを減らすことができます。
3. 実装・解決策：ドライラン（空実行）の活用
コマンド末尾に `-n` をつけることで、実際に削除するのではなく「削除される予定のファイル一覧」を表示する「ドライラン（Dry run）」モードになります。
手順は非常にシンプルです。
1. まず `git clean -n` で削除対象を確認する。
2. リストを見て「消して問題ない」と確信できたら、改めて削除コマンドを実行する。
この2ステップを習慣にするだけで、大切なファイルを誤って消すリスクをゼロにできます。
4. サンプルプログラム：実践的な操作フロー
以下は、現場でよく使われるコマンドの例です。コピー＆ペーストして、まずは確認から始めてみましょう。
1. まずはドライランで削除予定を確認（-n オプション）
これを実行してもファイルは一切削除されません
git clean -n
2. 確認して問題がなければ、実際に削除を実行
-f (force): 強制削除
-d (directory): ディレクトリも含めて削除
git clean -fd
3. 実行後の状態を確認
git status
※ `git clean -fd` は非常に強力です。必ず事前に `-n` で結果を確認するようにしてください。
5. 応用・注意点：現場で陥りやすい罠
現場でよくある失敗は、`.gitignore` の設定忘れです。
`git clean` は `.gitignore` に含まれていないファイルを削除します。もし「消したくないファイル」が削除対象リストに出てきたら、それは `.gitignore` に追記漏れがあるサインです。
また、`git clean` は「Git管理外のファイル」しか消しません。`git add` 済みのファイルを消したい場合は `git rm` を使う必要があります。これら2つのコマンドの違いを正しく理解し、まずは `-n` でプレビューする癖を今日から身につけましょう。
コメント