日本語 ▾ トピック ▾ 最新バージョン ▾ git-clean は 2.45.0 で最終更新されました

名前

git-clean - 作業ツリーから追跡されていないファイルを削除する

概要

git clean [-d] [-f] [-i] [-n] [-q] [-e <pattern>] [-x | -X] [--] [<pathspec>…​]

説明

現在のディレクトリから開始して、バージョン管理下にないファイルを再帰的に削除することで、作業ツリーをクリーンアップします。

通常、Gitに認識されていないファイルのみが削除されますが、-x オプションが指定されている場合、無視されたファイルも削除されます。これは、たとえば、すべてのビルド生成物を削除するのに役立ちます。

オプションの <pathspec>... 引数が与えられた場合、パススペックに一致するパスのみが影響を受けます。

オプション

-d

通常、 が指定されていない場合、git clean は追跡されていないディレクトリに再帰せず、削除しすぎないようにします。このようなディレクトリにも再帰させるには -d を指定します。 が指定されている場合、-d は無関係です。指定されたパスに一致するすべての追跡されていないファイル（--force で言及されているネストされた git ディレクトリの例外を除く）が削除されます。

-f
--force

Git設定変数 clean.requireForce が false に設定されていない場合、git clean は -f が与えられない限り、ファイルやディレクトリの削除を拒否します。2回目の -f が与えられない限り、Gitは追跡されていないネストされたgitリポジトリ（.gitサブディレクトリを持つディレクトリ）の変更を拒否します。

-i
--interactive

何が実行されるかを表示し、ファイルを対話的にクリーンアップします。詳細は「対話モード」を参照してください。このモードは対話式に動作することで独自の安全保護を提供するため、設定変数 clean.requireForce は無視されます。

-n
--dry-run

実際には何も削除せず、何が実行されるかだけを表示します。何も削除されないため、設定変数 clean.requireForce は無視されます。

-q
--quiet

静かに実行し、エラーのみを報告し、正常に削除されたファイルは報告しません。

-e <パターン>
--exclude=<パターン>

標準の無視ルール（gitignore[5]参照）に加えて、指定された除外パターンを使用します。

-x

標準の無視ルール（gitignore[5]参照）は使用せず、コマンドラインの -e オプションで指定された無視ルールは引き続き使用します。これにより、ビルド生成物を含むすべての追跡されていないファイルを削除できます。これは、クリーンなビルドをテストするためのきれいな作業ディレクトリを作成するために（場合によっては git restore または git reset と組み合わせて）使用できます。

-X

Gitによって無視されたファイルのみを削除します。これは、すべてを一から再構築するのに役立ちますが、手動で作成されたファイルは保持されます。

対話モード

コマンドが対話モードに入ると、クリーンアップされるファイルとディレクトリが表示され、対話式コマンドループに入ります。

コマンドループは利用可能なサブコマンドのリストを表示し、「What now> 」というプロンプトを表示します。一般的に、プロンプトが単一の > で終わる場合、以下のように与えられた選択肢の中から1つだけを選び、Enterキーを押すことができます。

    *** Commands ***
	1: clean                2: filter by pattern    3: select by numbers
	4: ask each             5: quit                 6: help
    What now> 1

選択肢が一意である限り、上記で c または clean と入力することもできます。

メインコマンドループには6つのサブコマンドがあります。

clean

ファイルとディレクトリのクリーンアップを開始し、終了します。

パターンによるフィルタリング

これにより、削除されるファイルとディレクトリが表示され、「Input ignore patterns>>」というプロンプトが表示されます。スペース区切りのパターンを入力して、削除からファイルとディレクトリを除外できます。例：「*.c *.h」は「.c」と「.h」で終わるファイルを削除から除外します。フィルタリングされた結果に満足したら、ENTERキー（空）を押してメインメニューに戻ります。

番号で選択

これにより、削除されるファイルとディレクトリが表示され、「Select items to delete>>」というプロンプトが表示されます。プロンプトがこのように二重の >> で終わる場合、スペースまたはカンマで連結して複数の選択を行うことができます。また、範囲を指定することもできます。例：「2-5 7,9」はリストから2,3,4,5,7,9を選択します。範囲の2番目の番号が省略された場合、残りのすべてのアイテムが選択されます。例：「7-」はリストから7,8,9を選択します。すべてを選択するには * と入力できます。また、フィルタリングされた結果に満足したら、ENTERキー（空）を押してメインメニューに戻ります。

個別に確認

これによりクリーンアップが開始され、アイテムを削除するには1つずつ確認する必要があります。この操作は上記の2つの操作ほど効率的ではないことに注意してください。

終了

これは、クリーンアップを行わずに終了できます。

ヘルプ

対話式git-cleanの簡単な使用法を表示します。

設定

このセクションのこの行より下のすべての内容は、git-config[1] ドキュメントから選択的に含まれています。内容はそちらで見られるものと同じです。

clean.requireForce

-f が与えられない限り git-clean がファイルの削除を拒否するようにするブール値。デフォルトは true です。

関連項目

gitignore[5]

GIT

git[1]スイートの一部

scroll-to-top