git add

Beschreibung

Der Befehl git add fügt Änderungen im Arbeitsverzeichnis in den Staging-Bereich ein. Damit teilen Sie Git mit, dass Sie Updates für eine bestimmte Datei im nächsten Commit erfassen möchten. Um diese Änderungen tatsächlich zu speichern, müssen Sie außerdem git commit ausführen. In Kombination mit den oben genannten Befehlen ist auch der Befehl git status nützlich, um den Zustand des Arbeitsverzeichnisses und des Staging-Bereichs zu überprüfen.

Funktionsweise

Die Befehle git add und git commit werden verwendet, um Projektversionen im Repository-Verlauf zu erfassen. Sie sind für jeden Git-Nutzer unverzichtbar, da sie die Grundlage des Git-Workflows bilden.

Während der Entwicklung eines Projekts bearbeiten Sie zunächst Dateien im Arbeitsverzeichnis. Sobald eine Kopie des aktuellen Zustands zum Speichern bereit ist, stagen Sie die Änderungen mit git add. Der Befehl git add sollte jedes Mal ausgeführt werden, wenn Sie eine Datei ändern.

Staging-Bereich

Die Hauptaufgabe des Befehls git add besteht darin, Änderungen im Arbeitsverzeichnis in den Git-Staging-Bereich zu übernehmen. Der Staging-Bereich von Git ist eine seiner besonderen Eigenschaften, die es Ihnen ermöglicht, alle zusammenhängenden Änderungen in präzisen Snapshots zu sammeln. Erst danach können Sie diese Änderungen in den Verlauf Ihres Projekts committen.

Häufige Optionen

1. Staging von Änderungen in <file> für den nächsten Commit:

git add file

git add <file>

2. Staging aller Änderungen in <directory> für den nächsten Commit:

git add directory

git add <directory>

3. Staging aller Änderungen in bereits verfolgten Dateien:

git add -u

git add -u

4. Interaktiver Patch-Modus (Staging von Änderungen stückweise):

git add -p

git add -p

Beispiele für git add

Die Befehle git add und git commit werden verwendet, um einen ersten Commit des aktuellen Verzeichnisses zu erstellen sowie Änderungen an vorhandenen Dateien zu erfassen.

Nach Projektstart können Sie neue Dateien hinzufügen, indem Sie ihren Pfad an git add übergeben.

Eine Datei hinzufügen

git add hello.py

Änderungen committen

git commit

Interaktiver Modus

Eine interaktive Staging-Sitzung ermöglicht es Ihnen, Teile einer Datei auszuwählen, die dem nächsten Commit hinzugefügt werden sollen. Ihnen wird ein Änderungsbereich angezeigt und Sie werden zur Eingabe eines Befehls aufgefordert. Die verfügbaren Optionen sind:

• y - den Bereich stagen
• n - den Bereich nicht stagen
• q - beenden; den Bereich oder verbleibende Bereiche nicht stagen
• a - den Bereich und alle folgenden Bereiche in der Datei stagen
• d - den Bereich oder alle folgenden Bereiche in der Datei nicht stagen
• g - zu einem bestimmten Bereich springen
• / - nach einem Bereich suchen, der dem angegebenen Regex entspricht
• j - zum nächsten Bereich springen
• J - zum vorherigen Bereich springen
• k - zum vorherigen Bereich springen
• K - zum vorherigen unentschiedenen Bereich springen
• s - den aktuellen Bereich in kleinere aufteilen
• e - den aktuellen Bereich manuell bearbeiten
• ? - Hilfe anzeigen

Patches bearbeiten

Durch Aufruf von git add -e oder Auswahl von e im interaktiven Bereichsauswähler wird ein Patch in Ihrem Editor geöffnet. Nach dem Verlassen des Editors wird die Ausgabe auf den Index angewendet. Sie können beliebige Änderungen am Patch vornehmen, aber einige Bearbeitungen können zu komplexen Ausgaben führen oder den Patch sogar unanwendbar machen. Wenn Sie den Vorgang vollständig ablehnen möchten, löschen Sie einfach alle Zeilen des Patches. Hier sind einige häufige Elemente, die Sie in einem Patch sehen können, und welche Bearbeitungsschritte dafür sinnvoll sind.

Zeilen, die mit + beginnen, stellen hinzugefügten Inhalt dar. Sie können sie löschen, um zu verhindern, dass hinzugefügte Zeilen gestagt werden.

Zeilen, die mit - beginnen, stellen entfernten Inhalt dar. Um zu verhindern, dass ihre Löschung gestagt wird, können Sie das - in ein Leerzeichen () umwandeln.

Modifizierter Inhalt wird mit --Zeilen (Löschen des alten Inhalts) gefolgt von +-Zeilen (Hinzufügen des Ersatzinhalts) angezeigt. Um die Modifikation nicht zu stagen, wandeln Sie die --Zeilen in Leerzeichen um und entfernen Sie die +-Zeilen. Beachten Sie, dass die Änderung nur einer Hälfte des Paares zu verwirrenden Änderungen im Index führen kann.

Praxis

Welche Funktionen und Optionen sind mit dem Befehl 'git add' verbunden?

'git add' wird verwendet, um Änderungen im Arbeitsverzeichnis in den Staging-Bereich zu übernehmen.Der Befehl wird verwendet, um Änderungen direkt in das Repository zu committen.'git add <file>' staget Änderungen in einer bestimmten Datei für den nächsten Commit.'git add -u' staget alle Änderungen in bereits verfolgten Dateien.Der interaktive Modus in 'git add' ermöglicht die Auswahl bestimmter Dateiteile zum Stagen.Die Verwendung von 'git add -e' öffnet einen Patch im Editor zur detaillierten Bearbeitung vor dem Stagen.