English ▾ Themen ▾ Neueste Version ▾ git-clean zuletzt aktualisiert in 2.45.0

NAME

git-clean - Nicht verfolgte Dateien aus dem Arbeitsverzeichnis entfernen

SYNOPSIS

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

BESCHREIBUNG

Bereinigt das Arbeitsverzeichnis, indem Dateien, die nicht unter Versionskontrolle stehen, rekursiv entfernt werden, beginnend im aktuellen Verzeichnis.

Normalerweise werden nur Dateien entfernt, die Git unbekannt sind. Wenn jedoch die Option -x angegeben wird, werden auch ignorierte Dateien entfernt. Dies kann zum Beispiel nützlich sein, um alle Build-Produkte zu entfernen.

Wenn optionale Argumente vom Typ <Pfad-Spezifikation>... angegeben werden, werden nur die Pfade betroffen, die mit der Pfad-Spezifikation übereinstimmen.

OPTIONEN

-d

Wenn keine <Pfad-Spezifikation> angegeben ist, recursiert `git clean` normalerweise nicht in nicht verfolgte Verzeichnisse, um nicht zu viel zu entfernen. Geben Sie `-d` an, damit es auch in solche Verzeichnisse recursiert. Wenn eine <Pfad-Spezifikation> angegeben ist, ist `-d` irrelevant; alle nicht verfolgten Dateien, die mit den angegebenen Pfaden übereinstimmen (mit Ausnahmen für verschachtelte Git-Verzeichnisse, die unter --force erwähnt werden), werden entfernt.

-f
--force

Wenn die Git-Konfigurationsvariable `clean.requireForce` nicht auf `false` gesetzt ist, weigert sich `git clean`, Dateien oder Verzeichnisse zu löschen, es sei denn, es wird `-f` angegeben. Git weigert sich, nicht verfolgte, verschachtelte Git-Repositories (Verzeichnisse mit einem `.git`-Unterverzeichnis) zu ändern, es sei denn, es wird ein zweites `-f` angegeben.

-i
--interactive

Zeigt an, was getan würde, und bereinigt Dateien interaktiv. Siehe „Interaktiver Modus“ für Details. Die Konfigurationsvariable clean.requireForce wird ignoriert, da dieser Modus durch die interaktive Vorgehensweise eigene Sicherheitsvorkehrungen bietet.

-n
--dry-run

Entfernt nichts tatsächlich, sondern zeigt nur, was getan würde. Die Konfigurationsvariable clean.requireForce wird ignoriert, da sowieso nichts gelöscht wird.

-q
--quiet

Seien Sie leise, melden Sie nur Fehler, aber nicht die erfolgreich entfernten Dateien.

-e <Muster>
--exclude=<Muster>

Verwendet das angegebene Ausschlussmuster zusätzlich zu den Standard-Ignore-Regeln (siehe gitignore[5]).

-x

Verwendet nicht die Standard-Ignore-Regeln (siehe gitignore[5]), verwendet aber dennoch die mit `-e` Optionen von der Kommandozeile angegebenen Ignore-Regeln. Dies ermöglicht die Entfernung aller nicht verfolgten Dateien, einschließlich Build-Produkte. Dies kann (möglicherweise in Verbindung mit `git restore` oder `git reset`) verwendet werden, um ein sauberes Arbeitsverzeichnis zu erstellen, um einen sauberen Build zu testen.

-X

Entfernt nur von Git ignorierte Dateien. Dies kann nützlich sein, um alles von Grund auf neu zu erstellen, aber manuell erstellte Dateien beizubehalten.

Interaktiver Modus

Wenn der Befehl in den interaktiven Modus wechselt, zeigt er die zu bereinigenden Dateien und Verzeichnisse an und wechselt in seine interaktive Befehlsschleife.

Die Befehlsschleife zeigt die Liste der verfügbaren Unterbefehle an und gibt eine Eingabeaufforderung "Was nun> " aus. Im Allgemeinen, wenn die Eingabeaufforderung mit einem einzelnen > endet, können Sie nur eine der angezeigten Optionen auswählen und Enter drücken, wie hier:

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

Sie können auch c oder clean oben sagen, solange die Auswahl eindeutig ist.

Die Hauptbefehlsschleife hat 6 Unterbefehle.

clean

Beginnt mit der Bereinigung von Dateien und Verzeichnissen und wird dann beendet.

nach Muster filtern

Dies zeigt die zu löschenden Dateien und Verzeichnisse an und gibt eine Eingabeaufforderung "Ignore-Muster eingeben>>" aus. Sie können leerzeichengetrennte Muster eingeben, um Dateien und Verzeichnisse von der Löschung auszuschließen. z.B. "*.c *.h" schließt Dateien aus, die auf ".c" und ".h" enden. Wenn Sie mit dem gefilterten Ergebnis zufrieden sind, drücken Sie ENTER (leer), um zum Hauptmenü zurückzukehren.

nach Nummern auswählen

Dies zeigt die zu löschenden Dateien und Verzeichnisse an und gibt eine Eingabeaufforderung "Elemente zur Löschung auswählen>>" aus. Wenn die Eingabeaufforderung mit doppelten >> wie hier endet, können Sie mehr als eine Auswahl treffen, die mit Leerzeichen oder Kommas verknüpft ist. Sie können auch Bereiche angeben. z.B. "2-5 7,9", um 2,3,4,5,7,9 aus der Liste auszuwählen. Wenn die zweite Zahl in einem Bereich weggelassen wird, werden alle verbleibenden Elemente ausgewählt. z.B. "7-", um 7,8,9 aus der Liste auszuwählen. Sie können `*` sagen, um alles auszuwählen. Wenn Sie mit dem gefilterten Ergebnis zufrieden sind, drücken Sie ENTER (leer), um zum Hauptmenü zurückzukehren.

jede einzeln fragen

Dies beginnt mit der Bereinigung, und Sie müssen jeden einzelnen bestätigen, um Elemente zu löschen. Bitte beachten Sie, dass diese Aktion nicht so effizient ist wie die beiden oben genannten Aktionen.

beenden

Hiermit können Sie beenden, ohne etwas zu bereinigen.

hilfe

Zeigt eine kurze Übersicht über die interaktive `git-clean`-Nutzung an.

KONFIGURATION

Alles unterhalb dieser Zeile in diesem Abschnitt wird selektiv aus der git-config[1]-Dokumentation übernommen. Der Inhalt ist derselbe wie dort zu finden.

clean.requireForce

Ein Boolescher Wert, der dafür sorgt, dass `git-clean` sich weigert, Dateien zu löschen, es sei denn, `-f` wird angegeben. Standardwert ist `true`.

SIEHE AUCH

gitignore[5]

GIT

Teil der git[1] Suite