Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 10: Git im Terminal

Ziel: Git so bedienen, dass Historie, Branches und Fehlersuche ohne GUI schnell gehen. · Dauer: ca. 90 min · Voraussetzung: Tag 6

Briefing

  • Alle Drills nutzen die Lab-Konfiguration ~/term-lab/gitconfig über GIT_CONFIG_GLOBAL. Deine echte ~/.gitconfig bleibt unberührt.
  • switch und restore ersetzen die überladenen Varianten von checkout.
  • Fixup-Commits plus --autosquash räumen die Historie auf, bevor andere sie sehen.
  • Worktrees geben dir mehrere Branches gleichzeitig ausgecheckt, ohne stash.
  • bisect run findet den schuldigen Commit automatisch.
main ──A──B──C──D──E          feature/sub ──F──G──fixup!F
                                 rebase -i --autosquash  =>  F'──G'

Die Ausgaben stammen von Git 2.56 mit deutscher Locale. Mit LANG=C siehst du Englisch.

Drill 1: Lab-Konfiguration und Übungsrepo

Arbeite in der Übungs-zsh (~/term-lab/lab, Tag 0). Deren .zshenv setzt bereits GIT_CONFIG_GLOBAL=~/term-lab/gitconfig. Ersetze die Minimal-Konfig durch die ausführliche:

echo $GIT_CONFIG_GLOBAL
cp $BUCH/git/gitconfig ~/term-lab/gitconfig
git config --global --get-regexp '^(user|core|rebase)\.'

Erwartet:

/Users/<du>/term-lab/gitconfig
user.name Lab User
user.email [email protected]
core.editor nvim
core.pager delta --navigate --line-numbers
rebase.autosquash true
rebase.autostash true
rebase.updaterefs true

Achtung: Ist GIT_CONFIG_GLOBAL leer, bist du nicht in der Lab-zsh. Dann schreibt git config --global in deine echte ~/.gitconfig.

Jetzt ein Wegwerf-Repo mit etwas Historie:

mkdir -p ~/term-lab/tag10 && cd ~/term-lab/tag10 && git init -q
cat > calc.py <<'EOF'
def add(a, b):
    return a + b


def mul(a, b):
    return a * b
EOF
git add calc.py && git commit -qm "feat: add und mul"
for i in 1 2 3 4 5 6 7 8; do
  echo "# Schritt $i" >> NOTES.md
  git add NOTES.md && git commit -qm "docs: Schritt $i"
done
git ll | head -3
git aliases | head -4

Erwartet (Hashes weichen ab):

6008dd4 docs: Schritt 8
510cbe9 docs: Schritt 7
6bfef76 docs: Schritt 6
s status -sb
co switch
cob switch -c
unstage restore --staged

Die Aliase sind kurz, aber sprechend. git aliases listet sie dir jederzeit auf.

Fortschritt speichern? Kostenlos registrieren

Drill 2: switch und restore

git cob feature/sub
git co -
git co -
git branch --show-current
echo "kaputt" >> calc.py
git s
git restore calc.py
git s

Erwartet:

Zu neuem Branch 'feature/sub' gewechselt
Zu Branch 'main' gewechselt
Zu Branch 'feature/sub' gewechselt
feature/sub
## feature/sub
 M calc.py
## feature/sub

git switch - springt zum vorherigen Branch, genau wie cd -. git restore verwirft Änderungen im Arbeitsverzeichnis. git restore --staged (Alias unstage) holt nur aus dem Index.

Alt (checkout) Neu Wirkung
git checkout -b x git switch -c x Branch anlegen und wechseln
git checkout x git switch x Branch wechseln
git checkout -- f git restore f Änderung verwerfen
git reset HEAD f git restore --staged f aus dem Index nehmen

Fortschritt speichern? Kostenlos registrieren

Drill 3: Interaktives Staging

Du hast zwei Dinge geändert: eine Debug-Ausgabe (soll nicht ins Commit) und eine neue Funktion.

cat > calc.py <<'EOF'
def add(a, b):
    print("DEBUG add", a, b)
    return a + b


def mul(a, b):
    return a * b


def sub(a, b):
    return a - b
EOF
git add -p

Git zeigt einen einzigen Hunk. Tippe s (split), dann n für den Debug-Block und y für sub. Ablauf (gekürzt, Diff-Zeilen ausgelassen):

(1/1) Stage this hunk [y,n,q,a,d,s,e,p,P,?]? s
In 2 Patch-Block aufgeteilt.
+    print("DEBUG add", a, b)
(1/2) Stage this hunk [y,n,q,a,d,k,K,j,J,g,/,e,p,P,?]? n
+def sub(a, b):
+    return a - b
(2/2) Stage this hunk [y,n,q,a,d,K,J,g,/,e,p,P,?]? y
git diff --cached --stat
git diff --stat
git commit -qm "feat: sub"
git restore calc.py

Erwartet:

 calc.py | 4 ++++
 1 file changed, 4 insertions(+)
 calc.py | 1 +
 1 file changed, 1 insertion(+)

Das Debug-print bleibt ungestaged und fliegt mit restore raus. Lässt sich ein Hunk nicht splitten, weil die Zeilen direkt nebeneinander liegen, nimmst du e und editierst den Patch in Neovim.

Tipp: Weil interactive.diffFilter = delta --color-only gesetzt ist, ist auch add -p syntaxfarbig.

Fortschritt speichern? Kostenlos registrieren

Drill 4: fixup und autosquash

Du committest weiter und merkst dann, dass sub einen Docstring braucht. Der gehört inhaltlich in den alten Commit, nicht in einen neuen.

printf '\n\ndef div(a, b):\n    return a / b\n' >> calc.py
git commit -qam "feat: div"
perl -pi -e 's/^(    return a - b)/    """a minus b"""\n$1/' calc.py
git add calc.py
git fixup ":/feat: sub"
git ll | head -4

Erwartet:

[feature/sub 373eeea] fixup! feat: sub
 1 file changed, 1 insertion(+)
373eeea fixup! feat: sub
89fe008 feat: div
784c66d feat: sub
6008dd4 docs: Schritt 8

:/feat: sub adressiert den jüngsten Commit, dessen Nachricht auf das Muster passt. Du musst keinen Hash kopieren. Jetzt zeigst du dir die Todo-Liste an, ohne einen Editor zu öffnen:

GIT_SEQUENCE_EDITOR=cat git ri main
git ll | head -3

Erwartet (gekürzt):

pick 784c66d # feat: sub
fixup 373eeea # fixup! feat: sub
pick 89fe008 # feat: div
Erfolgreich Rebase ausgeführt und refs/heads/feature/sub aktualisiert.
a933236 feat: div
4ca2126 feat: sub
6008dd4 docs: Schritt 8

Warum? --autosquash sortiert fixup!-Commits hinter ihr Ziel. GIT_SEQUENCE_EDITOR=cat gibt die Liste nur aus und übernimmt sie unverändert. Im Alltag lässt du die Variable weg und bearbeitest die Liste in Neovim.

Befehl in der Todo-Liste Wirkung
pick / p Commit übernehmen
reword / r Nachricht ändern
edit / e anhalten, z. B. zum Aufteilen
fixup / f in Vorgänger falten, Nachricht verwerfen
squash / s falten, Nachrichten zusammenführen
drop / d Commit entfernen

Tipp: Geht ein Rebase schief, holt git reflog jeden alten Stand zurück. Mit git rebase --abort brichst du einen laufenden Rebase ab.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Worktrees

Ein Hotfix kommt rein, während dein Feature-Branch halb fertig ist. Statt stash:

git co main
git worktree add ../tag10-hotfix -b hotfix/mul
git wt
(cd ../tag10-hotfix && git s)

Erwartet:

Zu Branch 'main' gewechselt
Bereite Arbeitsverzeichnis vor (neuer Branch 'hotfix/mul')
HEAD ist jetzt bei 6008dd4 docs: Schritt 8
/Users/<du>/term-lab/tag10        6008dd4 [main]
/Users/<du>/term-lab/tag10-hotfix 6008dd4 [hotfix/mul]
## hotfix/mul

Ein Branch kann nur in einem Worktree ausgecheckt sein:

git switch hotfix/mul

Erwartet (umbrochen):

Schwerwiegend: 'hotfix/mul' wird bereits von Arbeitsverzeichnis in
'/Users/<du>/term-lab/tag10-hotfix' verwendet

Aufräumen:

git worktree remove ../tag10-hotfix
git branch -D hotfix/mul
git wt

Erwartet:

Branch hotfix/mul entfernt (war 6008dd4).
/Users/<du>/term-lab/tag10 6008dd4 [main]

Tipp: Pro Worktree eine tmux-Session (Tag 9) – so laufen Tests im Hotfix, während der Editor im Feature bleibt.

Fortschritt speichern? Kostenlos registrieren

Drill 6: bisect run

Zwölf Refactoring-Commits, einer davon bricht mul. Du baust den Fehler absichtlich ein:

git cob bug/hunt
for i in $(seq 1 12); do
  echo "# Refactor $i" >> calc.py
  [ $i -eq 7 ] && perl -pi -e 's/a \* b/a ** b/' calc.py
  git commit -qam "refactor: Schritt $i"
done
cat > test_mul.sh <<'EOF'
#!/bin/sh
python3 -c 'import calc; assert calc.mul(3, 4) == 12'
EOF
chmod +x test_mul.sh

bisect run wertet den Exit-Code aus: 0 heißt gut, 1–127 heißt schlecht, 125 heißt überspringen.

git bisect start HEAD main
git bisect run ./test_mul.sh 2>/dev/null
git bisect reset

Erwartet (gekürzt):

Binäre Suche: danach noch 5 Commits zum Testen übrig (ungefähr 3 Schritte)
Ausführen von './test_mul.sh'
Binäre Suche: danach noch 2 Commits zum Testen übrig (ungefähr 2 Schritte)
...
64a7aed91353974128d7f6f71fe37e04ab8b6548 is the first 'bad' commit
    refactor: Schritt 7
bisect found first 'bad' commit
Zu Branch 'bug/hunt' gewechselt

Vier Testläufe statt zwölf. Bei 1000 Commits wären es etwa zehn. Das Testskript liegt ungetrackt im Repo und überlebt daher jeden Checkout.

Fortschritt speichern? Kostenlos registrieren

Drill 7: delta, lazygit und gh

delta ist schon der Pager. Schau dir den schuldigen Commit aus Drill 6 an:

git show ":/refactor: Schritt 7"

Erwartet (Ausschnitt, im Terminal farbig):

Δ calc.py
────────────────────────────────────────────────────────────
  5 ⋮  5 │def mul(a, b):
  6 ⋮    │    return a * b
    ⋮  6 │    return a ** b

Mit n/N springst du zur nächsten/vorigen Datei, mit q raus. Für Side-by-Side reicht einmalig git -c core.pager='delta -s' show HEAD.

Achtung: delta liest seine [delta]-Sektion nur aus ~/.gitconfig, nicht aus GIT_CONFIG_GLOBAL. Deshalb stehen die Flags im Lab direkt in core.pager.

lazygit ist die TUI für alles, was in der CLI umständlich ist: Hunks stagen, Commits umsortieren, Konflikte auflösen.

lazygit --version | cut -d, -f4
lazygit

Erwartet:

 version=0.64.1
Taste in lazygit Wirkung
1–5 Panel wählen (Status, Files, Branches, Commits, Stash)
space Datei/Hunk stagen bzw. Branch auschecken
Enter in Datei springen, dort einzelne Zeilen stagen
c Commit schreiben
F (in Commits) Fixup-Commit für den markierten Commit
? alle Tasten im aktuellen Panel

gh bringt GitHub ins Terminal. Damit das Lab deine echte gh-Konfiguration nicht berührt, bekommt es ein eigenes Konfig-Verzeichnis:

export GH_CONFIG_DIR=~/term-lab/gh
gh alias set prs 'pr list --author "@me"'
gh alias list

Erwartet (co ist ein eingebauter Standard-Alias):

co: pr checkout
prs: pr list --author "@me"

Typische Befehle in einem echten Repo (Login per gh auth login nötig):

gh pr create --fill --draft      # PR aus Commits erzeugen
gh pr checks --watch             # CI live verfolgen
gh pr checkout 123               # PR lokal auschecken
gh run view --log-failed         # nur die roten Job-Logs

Fortschritt speichern? Kostenlos registrieren

Shortcut-Tabelle

Taste/Befehl Wirkung Merkhilfe
git co - zurück zum vorigen Branch wie cd -
y / n / s / e in add -p stagen / auslassen / teilen / editieren yes, no, split, edit
git fixup :/muster Fixup für Commit mit passender Nachricht :/ = Suche
git ri main Rebase mit autosquash rebase interactive
n / N in delta nächste / vorige Datei next
F in lazygit Fixup-Commit Fixup
git reflog jeden früheren HEAD finden Rettungsring

Kontrollpunkt

cd ~/term-lab/tag10
ok() { if eval "$1" >/dev/null 2>&1; then echo "✔ $2"; else echo "✘ $2"; fi; }
ok '[ "$GIT_CONFIG_GLOBAL" = "$HOME/term-lab/gitconfig" ]' "Lab-Gitconfig aktiv"
ok '[ "$(git config rebase.autosquash)" = true ]' "autosquash an"
ok '! git log --format=%s main..feature/sub | grep -q "^fixup!"' "keine fixup!-Commits"
ok '[ $(git rev-list --count main..feature/sub) -eq 2 ]' "feature/sub: 2 Commits"
ok 'git show feature/sub:calc.py | grep -q "a minus b"' "Docstring in sub"
ok '[ "$(git worktree list | wc -l)" -eq 1 ]' "kein verwaister Worktree"
ok '! git bisect log' "kein laufender Bisect"

Erwartet:

✔ Lab-Gitconfig aktiv
✔ autosquash an
✔ keine fixup!-Commits
✔ feature/sub: 2 Commits
✔ Docstring in sub
✔ kein verwaister Worktree
✔ kein laufender Bisect

Challenge

Benenne den Commit feat: div auf feature/sub in feat: div (ohne Nullprüfung) um. Kein Hash kopieren, kein interaktiver Editor.

Hinweis: git commit --fixup kennt die Form reword:<commit>, und GIT_EDITOR darf ein beliebiges Kommando sein.

Lösung

git co feature/sub
GIT_EDITOR="perl -pi -e 's/^feat: div\$/feat: div (ohne Nullprüfung)/'" \
  git commit -q --fixup=reword:":/feat: div"
git ll | head -2
GIT_SEQUENCE_EDITOR=: git ri main
git ll | head -3

Erwartet (gekürzt):

897dc3a amend! feat: div
8eef217 feat: div
Erfolgreich Rebase ausgeführt und refs/heads/feature/sub aktualisiert.
ba61ded feat: div (ohne Nullprüfung)
4ca2126 feat: sub
6008dd4 docs: Schritt 8

--fixup=reword: erzeugt einen leeren amend!-Commit mit neuer Nachricht. Autosquash faltet ihn wie jeden Fixup ein.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Name, E-Mail und Signatur pro Kontext trennen: includeIf "gitdir:~/work/" lädt eine Kunden-Konfig.
  • Commits signieren (gpg.format = ssh, commit.gpgSign = true) – oft Pflicht für geschützte Branches.
  • Nie auf geteilte Branches force-pushen; wenn nötig nur git push --force-with-lease.
  • fixup/rebase nur auf eigenen, noch nicht gemergten Branches. Squash-Merge-Policies im Repo prüfen.
  • gh in CI per GH_TOKEN aus dem Secret-Store, nie per persönlichem Login.