Zum Inhalt

git add

Merkt Änderungen für den nächsten Commit vor, indem es sie in den Staging-Bereich legt.

git-add output

Syntax

git add [OPTIONEN] PFAD...

Optionen

Option Beschreibung
PFAD Datei oder Verzeichnis; . heißt alles im aktuellen Verzeichnis und darunter
-A, --all Alle Änderungen im ganzen Repository, auch gelöschte Dateien
-u, --update Nur Dateien, die Git schon verfolgt, keine neuen
-p, --patch Stück für Stück auswählen, welche Änderungen hinzukommen
-n, --dry-run Nur anzeigen, was hinzugefügt würde
-f, --force Auch eine Datei hinzufügen, die .gitignore ausschließt

Beispiele

Eine Datei hinzufügen und das Ergebnis prüfen:

git add check-disk.sh
git status -s
M  check-disk.sh
 M backup.sh
?? notes.txt

check-disk.sh ist jetzt vorgemerkt (linke Spalte), backup.sh ist geändert, aber nicht vorgemerkt.

Sehen, was git add . tun würde:

git add -n .
add 'backup.sh'
add 'notes.txt'

Nur einen Teil der Änderungen hinzufügen:

git add -p backup.sh
diff --git a/backup.sh b/backup.sh
index 8791eb2..895c5d1 100644
--- a/backup.sh
+++ b/backup.sh
@@ -1,3 +1,4 @@
 #!/usr/bin/env bash
 set -euo pipefail
 nice -n 10 tar --zstd -cf "/mnt/backup/www-$(date +%F).tar.zst" -C /srv www
+echo "backup done"
(1/1) Stage this hunk [y,n,q,a,d,e,p,?]? y

Alle Änderungen an verfolgten Dateien hinzufügen:

git add -u
git status -s
M  backup.sh
M  check-disk.sh
?? notes.txt

Wann brauche ich das?

  • Vor jedem Commit, um genau festzulegen, was hineinkommt
  • Um mehrere Änderungen in einer Datei mit -p auf getrennte Commits aufzuteilen
  • Um neue Dateien ins Repository aufzunehmen

Saubere Commits mit -p

git add -p zeigt jeden geänderten Block und fragt y (hinzufügen) oder n (überspringen). So enthält ein Commit nur, was zusammengehört.

Vor git add . prüfen

git add . nimmt auch neue Dateien mit, die du vielleicht nicht im Repository haben willst, etwa Logdateien oder eine .env mit Passwörtern. Schau vorher in git status oder nutze -n.

Verwandte Befehle

git status · git commit · git restore · git diff