Zum Inhalt springen
Trainingslager IT-Trainingslager

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/zprofile den PATH um.
  • Verhalten steuerst du mit setopt. Die Completion lädst du mit compinit und stellst sie mit zstyle ein.
  • 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 true

Erwartet:

== 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 git

Erwartet:

/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 -l

Erwartet:

/Users/du/term-lab/bin
/opt/homebrew/bin
/opt/homebrew/sbin
       0

Warum so?

  • typeset -U path macht das Array eindeutig. Doppelte Einträge entstehen sonst bei jeder verschachtelten Shell, etwa in tmux.
  • path und PATH sind in zsh gekoppelt. Mit dem Array arbeitest du ohne Doppelpunkt-Gefummel.
  • fpath ist der Suchpfad für Funktionen und Completions. Homebrew legt dort _git, _brew, _gh und Co. ab.
  • (N) am Glob ist ein Qualifier: keine Fehlermeldung, wenn der Ordner leer ist (Tag 3).
  • bindkey -e erzwingt die Emacs-Tastenbelegung. Ohne die Zeile schaltet zsh wegen EDITOR=nvim in 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
true

Erwartet:

[lab] ~ % false
[lab] ~ 1 % true
[lab] ~ %

Fortschritt speichern? Kostenlos registrieren

Drill 4: Optionen lesen und schalten

setopt

Erwartet (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 autocd

Erwartet:

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 -v

Erwartet:

0   ~/term-lab
1   ~/term-lab/projekt/deploy/k8s
2   ~/term-lab/projekt/internal/cart
3   ~/term-lab/projekt
4   ~
cd -2

Erwartet:

~/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 _kubectl

Erwartet:

_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 _atuin in einen Ordner in fpath, statt sie bei jedem Start mit source <(...) 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 100

Erwartet (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
fi
hyperfine -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.d oder /etc/zshrc mit (VPN-Clients, Security-Agents). zsh -o sourcetrace -l -i -c exit zeigt dir in Sekunden, wer mitredet.
  • .zshenv läuft auch in jedem Skript, in cron und in CI-Jobs, die zsh nutzen. Ausgaben oder langsame Befehle dort brechen Automatisierung. Halte sie minimal.
  • compaudit meldet „insecure directories”, wenn Completion-Ordner für andere beschreibbar sind. Nicht mit compinit -u wegdrü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: shopt statt setopt, .bashrc und .bash_profile statt der zsh-Dateien.