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

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
-pauf 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.