Tag 2: zsh-Grundlagen
Ziel: Du weißt, welche Startdatei wann läuft, hast einen sauberen PATH, gute Completion und eine messbar schnelle Shell. · Dauer: ca. 75 min · Voraussetzung: Tag 0
Briefing
- zsh liest bis zu fünf eigene Startdateien. Welche, hängt davon ab, ob die Shell Login und/oder interaktiv ist.
- macOS startet in jedem neuen Terminal-Tab eine Login-Shell. Dabei
baut
/etc/zprofileden PATH um. - Verhalten steuerst du mit
setopt. Die Completion lädst du mitcompinitund stellst sie mitzstyleein. - Jede Millisekunde Startzeit zahlst du bei jedem Tab und jedem tmux-Pane. Miss sie.
.zshenv .zprofile .zshrc .zlogin .zlogout
Login+inter. 1 2 3 4 5 (exit)
nur inter. 1 2
Skript/-c 1
Vor jeder eigenen Datei liest zsh die Systemvariante aus
/etc (/etc/zshenv, /etc/zprofile,
/etc/zshrc, …), sofern vorhanden.
Drill 1: Die Reihenfolge sichtbar machen
Ein Wegwerf-ZDOTDIR, in dem jede Datei nur ihren Namen ausgibt:
T=~/term-lab/zsh-trace
mkdir -p $T
for f in .zshenv .zprofile .zshrc .zlogin .zlogout; do
echo "echo $f" > $T/$f
done
echo "== Login + interaktiv"; ZDOTDIR=$T zsh -l -i -c true
echo "== nur interaktiv"; ZDOTDIR=$T zsh -i -c true
echo "== Skript"; ZDOTDIR=$T zsh -c trueErwartet:
== Login + interaktiv
.zshenv
.zprofile
.zshrc
.zlogin
.zlogout
== nur interaktiv
.zshenv
.zshrc
== Skript
.zshenv
Daraus folgen drei Regeln:
| Datei | Was hinein gehört | Was nicht |
|---|---|---|
.zshenv |
Variablen, die auch Skripte brauchen (EDITOR,
LAB) |
Ausgaben, Aliase, langsame Befehle |
.zprofile |
Login-Einmaliges, z. B. brew shellenv |
Interaktives |
.zshrc |
alles Interaktive: Optionen, Completion, Prompt, Aliase | Variablen, die Skripte brauchen |
.zlogin und .zlogout brauchst du praktisch
nie.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Warum der PATH auf dem Mac kippt
Jetzt ein typischer Fehler: Homebrew in .zshenv vorne an
den PATH hängen.
echo 'path=(/opt/homebrew/bin $path)' > $T/.zshenv
rm $T/.zprofile $T/.zshrc $T/.zlogin $T/.zlogout
env -i HOME=$HOME TERM=$TERM PATH=/usr/bin:/bin ZDOTDIR=$T \
zsh -l -i -c 'print -l $path | grep -n .'Erwartet (gekürzt):
1:/usr/local/bin
2:/System/Cryptexes/App/usr/bin
3:/usr/bin
4:/bin
5:/usr/sbin
6:/sbin
...
11:/opt/homebrew/bin
/opt/homebrew/bin steht nicht mehr vorne, sondern an
Platz 11. Schuld ist /etc/zprofile: Es läuft
nach .zshenv und ruft
path_helper auf. Der setzt die Einträge aus
/etc/paths an den Anfang. Die Folge: git ist
plötzlich Apples Version aus /usr/bin, nicht die von
Homebrew.
which -a gitErwartet:
/opt/homebrew/bin/git
/usr/bin/git
So soll es in deiner Lab-Shell aussehen. Die Regel daraus:
PATH-Änderungen gehören in .zprofile oder
.zshrc, nie in .zshenv. Genau deshalb
schreibt Homebrew bei der Installation
eval "$(/opt/homebrew/bin/brew shellenv)" in die
.zprofile.
env -i startet übrigens mit leerer Umgebung. So siehst
du, was die Startdateien allein bewirken.
Aufräumen: rm -rf ~/term-lab/zsh-trace.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Die Lab-.zshrc ausbauen
Ersetze die Start-.zshrc aus Tag 0 durch eine
ordentliche Version:
cat > ~/term-lab/zsh/.zshrc <<'EOF'
# ~/term-lab/zsh/.zshrc – Stand Tag 2
# --- PATH: eindeutig, eigene Skripte zuerst ---------------------------
typeset -U path PATH fpath FPATH
path=("$LAB/bin" /opt/homebrew/bin /opt/homebrew/sbin $path)
fpath=(/opt/homebrew/share/zsh/site-functions $fpath)
# --- Optionen ---------------------------------------------------------
setopt AUTO_CD AUTO_PUSHD PUSHD_IGNORE_DUPS PUSHD_SILENT
setopt INTERACTIVE_COMMENTS EXTENDED_GLOB NO_BEEP
bindkey -e # Emacs-Tasten, obwohl EDITOR=nvim (Tag 3)
# --- Completion -------------------------------------------------------
autoload -Uz compinit
compinit -d "$ZDOTDIR/.zcompdump"
zstyle ':completion:*' menu select
zstyle ':completion:*' matcher-list 'm:{a-z}={A-Za-z}'
zstyle ':completion:*:descriptions' format '%F{yellow}-- %d --%f'
zstyle ':completion:*' use-cache on
zstyle ':completion:*' cache-path "$ZDOTDIR/.zcompcache"
# --- Prompt: Exit-Code nur bei Fehler ---------------------------------
PROMPT='%F{yellow}[lab]%f %F{cyan}%1~%f %(?..%F{red}%?%f )%# '
# --- eigene Dateien (ab Tag 5) ----------------------------------------
for f in "$LAB"/config/zsh/*.zsh(N); do source "$f"; done
EOF
exec ~/term-lab/lab
print -l $path[1,3]
print -l $path | sort | uniq -d | wc -lErwartet:
/Users/du/term-lab/bin
/opt/homebrew/bin
/opt/homebrew/sbin
0
Warum so?
typeset -U pathmacht das Array eindeutig. Doppelte Einträge entstehen sonst bei jeder verschachtelten Shell, etwa in tmux.pathundPATHsind in zsh gekoppelt. Mit dem Array arbeitest du ohne Doppelpunkt-Gefummel.fpathist der Suchpfad für Funktionen und Completions. Homebrew legt dort_git,_brew,_ghund Co. ab.(N)am Glob ist ein Qualifier: keine Fehlermeldung, wenn der Ordner leer ist (Tag 3).bindkey -eerzwingt die Emacs-Tastenbelegung. Ohne die Zeile schaltet zsh wegenEDITOR=nvimin den vi-Modus (Tag 3).- Der Prompt zeigt den Exit-Code rot, aber nur wenn er nicht 0 ist:
%(?..text).
Teste den Fehler-Prompt:
false
trueErwartet:
[lab] ~ % false
[lab] ~ 1 % true
[lab] ~ %
Fortschritt speichern? Kostenlos registrieren
Drill 4: Optionen lesen und schalten
setoptErwartet (in einem echten Terminal, kann abweichen):
autocd
autopushd
nobeep
combiningchars
extendedglob
interactive
interactivecomments
monitor
pushdignoredups
pushdsilent
shinstdin
zle
setopt ohne Argument zeigt nur, was vom Standard
abweicht. Groß- und Kleinschreibung sowie Unterstriche sind egal:
AUTO_CD, autocd und Auto_Cd sind
dieselbe Option.
[[ -o autocd ]] && echo "autocd an"
unsetopt autocd
echo $options[autocd]
setopt autocdErwartet:
autocd an
off
Das assoziative Array $options ist praktisch in
Skripten. Alle Optionen mit Erklärung stehen in
man zshoptions.
| Option | Wirkung |
|---|---|
AUTO_CD |
projekt statt cd projekt, ..
statt cd .. |
AUTO_PUSHD |
jedes cd legt das alte Verzeichnis auf den Stack |
PUSHD_IGNORE_DUPS |
keine Duplikate auf dem Stack |
INTERACTIVE_COMMENTS |
# funktioniert auch interaktiv als Kommentar |
EXTENDED_GLOB |
^, ~, # und Qualifier in
Globs (Tag 3) |
Fortschritt speichern? Kostenlos registrieren
Drill 5: Der Verzeichnis-Stack
cd ~/term-lab/projekt
cd internal/cart
cd ../../deploy/k8s
cd ~/term-lab
dirs -vErwartet:
0 ~/term-lab
1 ~/term-lab/projekt/deploy/k8s
2 ~/term-lab/projekt/internal/cart
3 ~/term-lab/projekt
4 ~
cd -2Erwartet:
~/term-lab/projekt/internal/cart
Noch schneller: cd - und dann ⇥. zsh zeigt
den Stack als Menü, du wählst mit den Pfeiltasten. Und dank
AUTO_CD reicht auch nur der Ordnername:
cd ~/term-lab
projekt
..Erwartet:
[lab] term-lab % projekt
[lab] projekt % ..
[lab] term-lab %
Fortschritt speichern? Kostenlos registrieren
Drill 6: Completion wie ein Profi
Das Menü bekommt noch eine Rückwärts-Taste:
cat >> ~/term-lab/zsh/.zshrc <<'EOF'
# --- Completion-Menü: ⇧⇥ rückwärts ------------------------------------
zmodload zsh/complist
bindkey -M menuselect '^[[Z' reverse-menu-complete
EOF
exec ~/term-lab/lab
zstyle -L ':completion:*' | head -3
bindkey -M menuselect '^[[Z'Erwartet:
zstyle ':completion:*' cache-path /Users/du/term-lab/zsh/.zcompcache
zstyle ':completion:*:descriptions' format '%F{yellow}-- %d --%f'
zstyle ':completion:*' matcher-list 'm:{a-z}={A-Za-z}'
"^[[Z" reverse-menu-complete
Jetzt von Hand, jeweils ohne ⏎:
| Eingabe | Was passiert |
|---|---|
git sw⇥ |
ergänzt zu git switch |
git switch ⇥ |
Menü mit feature/rabatt und main |
cd proj⇥ in ~/term-lab |
ergänzt projekt/ |
cd PROJ⇥ |
dank matcher-list auch groß geschrieben |
kill ⇥ |
Prozessliste mit PID und Befehl |
ls -⇥ |
alle Optionen mit Beschreibung |
git ⌃Xh |
zeigt, welche Completion-Funktion greift |
Im Menü bewegst du dich mit ⇥, ⇧⇥ und den
Pfeiltasten. ⏎ übernimmt, ⌃G bricht ab.
Woher kommen die Completions? Aus fpath:
whence -v _git _gh _kubectlErwartet:
_git is an autoload shell function
_gh is an autoload shell function
_kubectl is an autoload shell function
Tipp: Hat ein Tool keine Datei in
/opt/homebrew/share/zsh/site-functions, erzeugt es sie meist selbst, z. B.atuin gen-completions --shell zsh. Schreib die Ausgabe einmalig als_atuinin einen Ordner infpath, statt sie bei jedem Start mitsource <(...)neu zu erzeugen.
Fortschritt speichern? Kostenlos registrieren
Drill 7: Startzeit messen
Drei Shells im Vergleich: ganz ohne Konfiguration, deine Lab-Shell, deine echte Shell.
hyperfine -N -w 3 -r 20 'zsh -f -i -c exit' \
"env ZDOTDIR=$HOME/term-lab/zsh zsh -i -c exit" \
'zsh -i -c exit'Erwartet (gekürzt, deine Zahlen weichen ab):
Benchmark 1: zsh -f -i -c exit (20 runs)
Wall Time 2.2 ms ± 0.2 ms 2.0 ms … 2.6 ms
Benchmark 2: env ZDOTDIR=/Users/du/term-lab/zsh zsh -i -c exit (20 runs)
Wall Time 30.2 ms ± 0.8 ms 29.1 ms … 32.1 ms
Benchmark 3: zsh -i -c exit (20 runs)
Wall Time 63.8 ms ± 3.4 ms 59.4 ms … 71.6 ms
-N startet ohne Zwischen-Shell, -w 3 wärmt
den Cache vor. Faustregel: unter 50 ms merkst du nichts. Über 200 ms
nervt jeder neue Tab. Frameworks wie oh-my-zsh landen schnell bei 300 ms
und mehr. Darum steigen viele Senior Engineers auf eine schlanke
.zshrc plus starship um.
Wo geht die Zeit hin? Der Profiler zprof zeigt es pro
Funktion:
ZDOTDIR=~/term-lab/zsh zsh -i -c \
'zmodload zsh/zprof; source $ZDOTDIR/.zshrc; zprof | head -4'Erwartet (gekürzt, deine Zahlen weichen ab):
num calls time self name
-----------------------------------------------------------------------------------
1) 2 11,39 5,69 62,02% 11,39 5,69 62,02% compaudit
2) 1 18,36 18,36 100,00% 6,97 6,97 37,98% compinit
Der Löwenanteil ist compaudit: die Sicherheitsprüfung
aller Completion-Ordner. Die Challenge macht sie billiger.
Fortschritt speichern? Kostenlos registrieren
Shortcut-Tabelle
| Taste | Wirkung | Merkhilfe |
|---|---|---|
⇥ |
ergänzen, zweimal: Menü | Tab = tippen sparen |
⇧⇥ |
im Menü rückwärts | Shift = zurück |
⌃G |
Menü abbrechen | Go away |
⌃D |
Möglichkeiten auflisten (mitten in der Zeile) | Display |
⌃Xh |
welche Completion greift hier? | help |
cd -⇥ |
Verzeichnis-Stack als Menü | minus = zurück |
.. |
eine Ebene hoch (AUTO_CD) |
zwei Punkte |
Kontrollpunkt
LAB=${LAB:-~/term-lab}
ok() { local m=$1; shift; "$@" >/dev/null 2>&1 && echo "✔ $m" || echo "✘ $m"; }
lab() { env ZDOTDIR="$LAB/zsh" zsh -i -c "$1" 2>/dev/null; }
ms=$(LAB=$LAB zsh -fc 'zmodload zsh/datetime; s=$EPOCHREALTIME
repeat 10 { ZDOTDIR=$LAB/zsh zsh -i -c exit }
printf "%.0f" $(( (EPOCHREALTIME - s) * 100 ))')
ok "kein doppelter PATH" test -z "$(lab 'print -l $path | sort | uniq -d')"
ok "Homebrew-git zuerst" test "$(lab 'whence -p git')" = /opt/homebrew/bin/git
ok "AUTO_CD an" lab '[[ -o autocd ]]'
ok "Completion geladen" lab '(( $+functions[compdef] ))'
ok "Start ${ms} ms < 100" test "$ms" -lt 100Erwartet (deine Zahl weicht ab):
✔ kein doppelter PATH
✔ Homebrew-git zuerst
✔ AUTO_CD an
✔ Completion geladen
✔ Start 30 ms < 100
$EPOCHREALTIME aus dem Modul zsh/datetime
ist eine Uhr mit Mikrosekunden. Zehn Starts, mal 100, ergibt den
Mittelwert in Millisekunden.
Challenge
compaudit prüft bei jedem Start alle Completion-Ordner.
Sorge dafür, dass die volle Prüfung nur noch einmal am Tag läuft und
sonst der Cache in .zcompdump reicht. Miss vorher und
nachher.
Hinweis: compinit -C überspringt die
Prüfung. Der Glob-Qualifier (#qN.mh+24) passt nur auf
Dateien, die älter als 24 Stunden sind.
Lösung
Ersetze in ~/term-lab/zsh/.zshrc die Zeile
compinit -d … durch:
if [[ -n $ZDOTDIR/.zcompdump(#qN.mh+24) ]]; then
compinit -d "$ZDOTDIR/.zcompdump" # einmal am Tag: voll prüfen
else
compinit -C -d "$ZDOTDIR/.zcompdump" # sonst: Cache ohne Audit
fihyperfine -N -w 3 -r 20 "env ZDOTDIR=$HOME/term-lab/zsh zsh -i -c exit"Erwartet (gekürzt, deine Zahlen weichen ab):
Wall Time 21.4 ms ± 0.6 ms 20.9 ms … 23.2 ms
Von 30 auf 21 ms, ein knappes Drittel. Der Qualifier liest sich so:
#q = Qualifier in [[ ]] erlaubt,
N = kein Fehler ohne Treffer, . = normale
Datei, mh+24 = Änderungszeit mehr als 24 Stunden her. Fehlt
.zcompdump ganz, legt compinit -C sie neu
an.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Firmen-Macs bringen oft eigene Einträge in
/etc/paths.doder/etc/zshrcmit (VPN-Clients, Security-Agents).zsh -o sourcetrace -l -i -c exitzeigt dir in Sekunden, wer mitredet. .zshenvläuft auch in jedem Skript, in cron und in CI-Jobs, die zsh nutzen. Ausgaben oder langsame Befehle dort brechen Automatisierung. Halte sie minimal.compauditmeldet „insecure directories”, wenn Completion-Ordner für andere beschreibbar sind. Nicht mitcompinit -uwegdrücken, sondern Rechte reparieren:compaudit | xargs chmod g-w,o-w.- Teile im Team eine gemeinsame Basis (Optionen, Completion, PATH) als Datei im Dotfiles-Repo. Persönliches kommt in eine lokale Zusatzdatei, die nicht ins Repo gehört (Tag 13).
- Server-Shells sind oft bash. Was du hier lernst, gilt dort
weitgehend auch. Unterschiede:
shoptstattsetopt,.bashrcund.bash_profilestatt der zsh-Dateien.