Tag 0: Das Trainingsgelände aufbauen
Ziel: Alle Werkzeuge sind da,
~/term-labsteht, die Übungs-zsh startet isoliert. · Dauer: ca. 30 min · Voraussetzung: keine
Briefing
- Alles läuft auf einem Mac mit Apple Silicon. Homebrew liegt unter
/opt/homebrew, die Standard-Shell ist zsh. - Die Werkzeuge stehen in einem
Brewfile. Ein Befehl prüft, ein Befehl installiert. - Dein Übungs-Home ist
~/term-lab. Die Übungs-zsh liest ihre Konfiguration aus~/term-lab/zshstatt aus~. - Das Übungsprojekt
~/term-lab/projektist ein kleines Git-Repo mit Go, Python, YAML und Logs. - Eine Nerd Font liefert die Symbole für Prompt,
ezaund Neovim.
~/term-lab/
├── lab Startskript: Übungs-zsh öffnen
├── zsh/ ZDOTDIR: .zshenv, .zshrc, .zsh_history
├── config/zsh/ eigene *.zsh-Dateien (ab Tag 5)
├── config/starship.toml
├── tmux.conf (ab Tag 8)
├── gitconfig GIT_CONFIG_GLOBAL für die Drills
├── bin/ eigene Skripte, steht im PATH
└── projekt/ Übungsprojekt "shop" (Git-Repo)
Drill 1: System prüfen
sw_vers -productVersion
uname -m
echo $SHELL
zsh --version
brew --prefixErwartet (kann je nach Version abweichen):
15.6.1
arm64
/bin/zsh
zsh 5.9 (arm64-apple-darwin24.0)
/opt/homebrew
Steht bei uname -m x86_64, läuft dein
Terminal unter Rosetta. Dann liegt Homebrew unter
/usr/local. Prüfe in den Informationen der Terminal-App im
Finder, ob „Mit Rosetta öffnen” aktiv ist.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Das Brewfile
Das Begleitmaterial liegt auf GitHub. Hol es und merk dir den Pfad in einer Variablen:
git clone https://github.com/thomaszachmann/mac-terminal-zum-anfassen.git \
~/mac-terminal-zum-anfassen
export BUCH=~/mac-terminal-zum-anfassen
ls $BUCH/brew $BUCH/setupErwartet:
Cloning into '/Users/du/mac-terminal-zum-anfassen'...
/Users/du/mac-terminal-zum-anfassen/brew:
Brewfile
/Users/du/mac-terminal-zum-anfassen/setup:
projekt-dateien.sh term-lab-setup.sh
Ein Auszug aus dem Brewfile:
cask "iterm2"
cask "ghostty"
cask "font-jetbrains-mono-nerd-font"
brew "tmux"
brew "starship"
brew "fzf"
brew "tlrc" # liefert den Befehl tldr
brew "kubectx" # liefert kubectx und kubens
Erst prüfen, nichts installieren:
brew bundle check --verbose --file=$BUCH/brew/BrewfileErwartet (gekürzt, hängt von deinem Mac ab):
brew bundle can't satisfy your Brewfile's dependencies.
→ Cask ghostty needs to be installed or updated.
→ Formula starship needs to be installed or updated.
→ Formula tlrc needs to be installed or updated.
→ Formula httpie needs to be installed or updated.
→ Formula entr needs to be installed or updated.
Satisfy missing dependencies with `brew bundle install`.
„installed or updated” heißt: fehlt oder ist veraltet. Jetzt installieren, ohne Vorhandenes zu aktualisieren:
brew bundle install --no-upgrade --file=$BUCH/brew/Brewfile
brew bundle check --file=$BUCH/brew/BrewfileErwartet (gekürzt, kann je nach Version abweichen):
Installing ghostty
Installing starship
...
`brew bundle` complete! 32 Brewfile dependencies now installed.
The Brewfile's dependencies are satisfied.
Warum --no-upgrade? Ein Lab-Setup soll nicht nebenbei
deine Arbeitswerkzeuge auf neue Major-Versionen heben. Aktualisieren ist
eine bewusste Entscheidung (Tag 13).
Tipp: Das Brewfile ist dein erstes Stück „Mac als Code”. An Tag 13 erzeugst du es mit
brew bundle dumpaus deinem echten System.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Übungs-Home anlegen
Das Setup-Skript legt ~/term-lab an. Es fasst weder
~/.zshrc noch ~/.gitconfig an:
bash $BUCH/setup/term-lab-setup.shErwartet:
✔ projekt: 4 Commits, 500 Logzeilen
✔ Übungs-Home: /Users/du/term-lab
Start: /Users/du/term-lab/lab
Ein zweiter Aufruf ändert nichts. Das Skript ist idempotent:
bash $BUCH/setup/term-lab-setup.shErwartet:
projekt existiert schon – unverändert (neu bauen mit --reset)
✔ Übungs-Home: /Users/du/term-lab
Start: /Users/du/term-lab/lab
Der Kern ist das Startskript ~/term-lab/lab:
cat ~/term-lab/labErwartet:
#!/bin/sh
# Startet die Übungs-zsh. Die echte ~/.zshrc bleibt unberührt.
LAB="${LAB:-$HOME/term-lab}"
exec env LAB="$LAB" ZDOTDIR="$LAB/zsh" zsh -i "$@"
Warum ZDOTDIR? zsh sucht .zshenv,
.zshrc und .zsh_history in
$ZDOTDIR. Ist die Variable nicht gesetzt, nimmt zsh
$HOME. Ein Umbiegen von HOME wäre
gefährlicher: dann fänden auch git, ssh und alle anderen Tools ihre
Konfiguration nicht mehr.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Die Übungs-zsh starten
~/term-lab/lab
echo $ZDOTDIR
echo $HISTFILE
echo $GIT_CONFIG_GLOBAL
git config user.nameErwartet:
[lab] ~ % echo $ZDOTDIR
/Users/du/term-lab/zsh
/Users/du/term-lab/zsh/.zsh_history
/Users/du/term-lab/gitconfig
Lab User
Der gelbe Präfix [lab] zeigt dir immer, dass du im
Übungs-Home bist. Deine History landet in einer eigenen Datei. Git nimmt
die Lab-Konfiguration.
Welche Dateien hat diese zsh beim Start gelesen? Die Option
sourcetrace verrät es:
ZDOTDIR=~/term-lab/zsh zsh -o sourcetrace -i -c exitErwartet:
+/Users/du/term-lab/zsh/.zshenv:1> <sourcetrace>
+/etc/zshrc:1> <sourcetrace>
+/Users/du/term-lab/zsh/.zshrc:1> <sourcetrace>
Keine Spur von ~/.zshrc. Genau das wollen wir. Mit
exit oder ⌃D kommst du zurück in deine normale
Shell.
Achtung: Startest du ein neues Fenster oder einen neuen Tab, bist du wieder in deiner echten Shell. Tippe dann erneut
~/term-lab/lab. An Tag 1 baust du dafür ein eigenes Terminal-Profil.
Fortschritt speichern? Kostenlos registrieren
Drill 5: Das Übungsprojekt erkunden
cd ~/term-lab/projekt
git log --oneline --graph --all --decorate
git branchErwartet:
* 375fbf7 (feature/rabatt) feat: Rabatt-Schalter
* 2e4e6aa (HEAD -> main) chore: Config, Manifeste, Report
* a57983c feat: Warenkorb und HTTP-Server
* 1dc0abc init: Projektgerüst
feature/rabatt
* main
Die Commits haben feste Datumswerte und den Autor „Lab User”. Darum siehst du dieselben Hashes wie im Buch.
find . -path ./.git -prune -o -type f -print | sortErwartet:
./.gitignore
./cmd/shop/main.go
./config/app.json
./config/app.yaml
./deploy/k8s/deployment.yaml
./docs/notizen.txt
./go.mod
./internal/cart/cart.go
./logs/access.log
./logs/app.log
./README.md
./scripts/report.py
Die Logs stehen in .gitignore. Das ist Absicht: An Tag 6
siehst du, warum rg sie nicht findet.
python3 scripts/report.py
grep -rn TODO --include='*.go' --include='*.py' .Erwartet:
INFO 350
WARN 50
ERROR 50
DEBUG 50
internal/cart/cart.go:16: // TODO: Rabatte berücksichtigen
cmd/shop/main.go:13: port = "8080" // TODO: aus config/app.yaml lesen
scripts/report.py:13:# TODO: als JSON ausgeben
Fortschritt speichern? Kostenlos registrieren
Drill 6: Nerd Font prüfen
Eine Nerd Font ist eine normale Programmierschrift plus einige
tausend Symbole: Git-Zweig, Ordner, Sprach-Logos, Powerline-Pfeile.
Prompt, eza --icons und Neovim brauchen sie.
ls ~/Library/Fonts | grep -E 'JetBrainsMonoNerdFont(Mono)?-Regular'
brew list --cask --versions font-jetbrains-mono-nerd-fontErwartet (kann je nach Version abweichen):
JetBrainsMonoNerdFont-Regular.ttf
JetBrainsMonoNerdFontMono-Regular.ttf
font-jetbrains-mono-nerd-font 3.4.0
Die Variante NerdFontMono hat streng einspaltige
Symbole. Sie passt am besten in Terminals. Jetzt der Sichttest:
printf ' \U000f0219 \n'Erwartet: fünf Symbole (Pfeil, Git-Zweig, Ordner, Dokument, Branch). Siehst du Kästchen oder Fragezeichen, nutzt deine Terminal-App noch keine Nerd Font. Das stellst du an Tag 1 um.
Fortschritt speichern? Kostenlos registrieren
Drill 7: Neu bauen und aufräumen
Du hast das Projekt verbastelt? Dann baust du nur das Projekt neu.
Deine Lab-Konfiguration unter zsh/ bleibt erhalten:
bash $BUCH/setup/term-lab-setup.sh --resetErwartet:
✔ projekt: 4 Commits, 500 Logzeilen
✔ Übungs-Home: /Users/du/term-lab
Start: /Users/du/term-lab/lab
Komplett entfernen geht genauso einfach, denn außerhalb von
~/term-lab gibt es nichts:
echo rm -rf ~/term-lab # erst ansehen, dann ohne echoSicherheit: Gewöhn dir
echovorrm -rfmit Variablen oder~an. Ein leeres$LABmacht ausrm -rf "$LAB/projekt"sonstrm -rf /projekt. Das Setup-Skript schützt sich mitset -u.
Fortschritt speichern? Kostenlos registrieren
Shortcut-Tabelle
| Taste | Wirkung | Merkhilfe |
|---|---|---|
⌃D |
Shell beenden (bei leerer Zeile) | Done |
⌃C |
laufenden Befehl abbrechen | Cancel |
⌃L |
Bildschirm leeren, Zeile bleibt | Leeren |
⌘K |
Scrollback der Terminal-App löschen | Kill buffer |
⌘T / ⌘N |
neuer Tab / neues Fenster | Tab, New |
Kontrollpunkt
LAB=${LAB:-~/term-lab}
ok() { local m=$1; shift; "$@" >/dev/null 2>&1 && echo "✔ $m" || echo "✘ $m"; }
hist=$(env ZDOTDIR="$LAB/zsh" zsh -i -c 'echo $HISTFILE')
ok "Startskript" test -x "$LAB/lab"
ok "Lab-.zshrc" test -f "$LAB/zsh/.zshrc"
ok "Projekt-Repo" test "$(git -C "$LAB/projekt" rev-list --count --all)" = 4
ok "eigene History" test "$hist" = "$LAB/zsh/.zsh_history"
ok "Nerd Font" sh -c 'ls ~/Library/Fonts | grep -q NerdFont'
for t in tmux fzf rg fd bat eza zoxide atuin nvim jq gh; do
ok "Tool $t" command -v $t
doneErwartet (gekürzt):
✔ Startskript
✔ Lab-.zshrc
✔ Projekt-Repo
✔ eigene History
✔ Nerd Font
✔ Tool tmux
...
✔ Tool gh
Challenge
Terminal-Apps auf dem Mac starten die Shell als Login-Shell. Starte die Übungs-zsh als Login-Shell und finde heraus, welche Startdatei dann zusätzlich gelesen wird.
Hinweis: man zsh, Abschnitt
STARTUP/SHUTDOWN FILES, und die Option -l.
Lösung
ZDOTDIR=~/term-lab/zsh zsh -l -o sourcetrace -i -c exitErwartet:
+/Users/du/term-lab/zsh/.zshenv:1> <sourcetrace>
+/etc/zprofile:1> <sourcetrace>
+/etc/zshrc:1> <sourcetrace>
+/Users/du/term-lab/zsh/.zshrc:1> <sourcetrace>
Neu ist /etc/zprofile. Dort ruft macOS
path_helper auf und baut den PATH aus
/etc/paths und /etc/paths.d/. Eine eigene
.zprofile in ~/term-lab/zsh würde direkt
danach gelesen. Warum das für einen sauberen PATH wichtig ist, siehst du
an Tag 2.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Auf Firmen-Macs verwaltet oft MDM (Jamf, Intune, Kandji) die
Software. Prüfe, ob Homebrew erlaubt ist und ob ein interner Mirror oder
Proxy (
HOMEBREW_ARTIFACT_DOMAIN,HTTPS_PROXY) nötig ist. - Leg das Brewfile ins Team-Repo. Neue Kolleginnen und Kollegen sind
dann mit
brew bundle installin Minuten arbeitsfähig. - Pinne kritische Versionen bewusst und aktualisiere gesammelt mit
brew bundle installplus Changelog-Check, nicht nebenbei. - Schriftarten und Casks brauchen manchmal Admin-Rechte. Kläre das vor dem Onboarding-Tag, nicht währenddessen.
- Das Muster „eigenes Übungs-Home per
ZDOTDIR” eignet sich auch für Schulungen und Pairing auf fremden Rechnern: nichts wird überschrieben, alles lässt sich mit einemrm -rfentfernen.