G1Joshi/Agent-Skills

Zsh

Zsh ist die Standard-Shell auf macOS. Sie ist hochgradig anpassbar und mit Bash kompatibel.

Wann verwenden

• Hochproduktive interaktive Shell: Interaktive Autovervollständigung, Fuzzy-Navigation, Verlaufssuche und Zweiganzeigen.
• Modernes CLI-Plugin-Ökosystem: Beschleunigung von Shell-Workflows mit zsh-autosuggestions, zsh-syntax-highlighting und Starship-Prompt.
• Robustes Shell-Scripting: Erstellung von POSIX-kompatiblen und Zsh-erweiterten Automatisierungsskripten mit Array-Manipulation und Globbing.
• Enterprise-Umgebungsverwaltung: Verwalten von SDK-Versionen, PATH-Exporten und Aliasen auf macOS- und Linux-Servern.

Schnellstart

1. Minimale ~/.zshrc-Einrichtung

# Verlaufskonfiguration
HISTFILE="$HOME/.zsh_history"
HISTSIZE=50000
SAVEHIST=50000
setopt HIST_IGNORE_DUPS
setopt SHARE_HISTORY

# Tastenkombinationen (Emacs-Modus)
bindkey -e

# Autovervollständigung
autoload -Uz compinit && compinit

# Aliase
alias ll="ls -lah"
alias g="git"
alias gs="git status -sb"

2. Startzeit messen

# Zsh-Startdauer profilieren
time zsh -i -c exit

Kernkonzepte

Hochgeschwindigkeits-Zshrc (~/.zshrc)

Konfiguration einer Shell-Startzeit unter 20 ms, intelligente Vervollständigung und Verlauf:

# ~/.zshrc
# Verlaufskonfiguration
HISTFILE="$HOME/.zsh_history"
HISTSIZE=50000
SAVEHIST=50000
setopt EXTENDED_HISTORY
setopt HIST_EXPIRE_DUPS_FIRST
setopt HIST_IGNORE_DUPS
setopt HIST_IGNORE_SPACE
setopt HIST_VERIFY
setopt SHARE_HISTORY

# Verzeichnisnavigation-Optionen
setopt AUTO_CD
setopt AUTO_PUSHD
setopt PUSHD_IGNORE_DUPS
setopt PUSHD_SILENT

# Schnelles Vervollständigungssystem (mit Caching)
autoload -Uz compinit
typeset -i updated_at=$(date +'%j' -r ~/.zcompdump 2>/dev/null || stat -f '%Sm' -t '%j' ~/.zcompdump 2>/dev/null)
if [ $(date +'%j') != $updated_at ]; then
  compinit -i
else
  compinit -C -i
fi

# Moderne Tastenkombinationen: Verlaufssuche
bindkey -e
bindkey '^[[A' history-search-backward
bindkey '^[[B' history-search-forward

# Starship-Prompt initialisieren (falls installiert)
if command -v starship &> /dev/null; then
  eval "$(starship init zsh)"
fi

Leichtgewichtiges Plugin-Laden ohne schwere Frameworks

Direktes Laden von Autosuggestions und Syntaxhervorhebung:

# Plugins nach ~/.zsh/plugins/ klonen
# git clone https://github.com/zsh-users/zsh-autosuggestions ~/.zsh/plugins/zsh-autosuggestions
# git clone https://github.com/zsh-users/zsh-syntax-highlighting ~/.zsh/plugins/zsh-syntax-highlighting

source ~/.zsh/plugins/zsh-autosuggestions/zsh-autosuggestions.zsh
source ~/.zsh/plugins/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh

# Vorschlagsfarbe konfigurieren
ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE='fg=8'

Fortgeschrittenes Zsh-Globbing & Parameterexpansion

Nutzung von rekursivem Globbing und Modifikatoren:

# Alle TypeScript-Dateien auflisten, die in den letzten 24 Stunden geändert wurden
ls -lh **/*.ts(m-1)

# Alle leeren Verzeichnisse rekursiv löschen
rmdir -p **/*(/^F) 2>/dev/null

# Nur ausführbare Dateien in bin/ auswählen
chmod +x bin/*(*)

Häufige Muster

Hochgeschwindigkeits-Plugin-Laden mit Zinit

Problem: Oh My Zsh startet aufgrund von schwerem eager Loading hunderte Millisekunden.
Lösung: Verwenden Sie Zinit mit Turbo-Modus (verzögertes Laden).

# Zinit installieren, falls nicht vorhanden
source ~/.local/share/zinit/zinit.git/zinit.zsh

# Turbo-Laden von Syntaxhervorhebung und Autosuggestions asynchron
zinit wait lucid for \
  atinit"ZINIT[COMPINIT_OPTS]=-C; zicompinit; zicdreplay" \
    zdharma-continuum/fast-syntax-highlighting \
  atload"_zsh_autosuggest_start" \
    zsh-users/zsh-autosuggestions \
  blockf \
    zsh-users/zsh-completions

Robuste Shell-Scripting-Funktionen

Problem: Wiederverwendbare Shell-Funktionen mit Optionsanalyse und Fehlerbehandlung schreiben.
Lösung: Verwenden Sie standardmäßige Zsh-Parameterexpansionen.

# mkcd: Verzeichnis erstellen und hineinwechseln
mkcd() {
  if [[ -z "$1" ]]; then
    echo "Verwendung: mkcd <verz>" >&2
    return 1
  fi
  mkdir -p "$1" && cd "$1"
}

Best Practices (2026)

• Tun: Kompilieren Sie ~/.zcompdump in eine byte-kompilierte Datei (compdump.zwc), um die Shell-Startzeit zu beschleunigen.
• Tun: Setzen Sie setopt SHARE_HISTORY, um den Befehlsverlauf über alle aktiven Terminal-Tabs zu synchronisieren.
• Tun: Verwenden Sie Starship oder ein schlankes natives Prompt anstelle von aufgeblähten Legacy-Prompt-Themes.
• Tun: Profilieren Sie die Startlatenz mit zmodload zsh/zprof am Anfang und Ende der ~/.zshrc.
• Nicht: Verwenden Sie schwere, aufgeblähte Framework-Konfigurationen (monolithische Oh-My-Zsh-Konfigurationen) mit Dutzenden unnötiger Plugins.
• Nicht: Speichern Sie Cloud-Anmeldedaten, API-Tokens oder Geheimnisse im Klartext in ~/.zshrc; verwenden Sie private .env-Dateien oder Geheimnisverwaltungen.
• Nicht: Führen Sie langsame externe Befehle (nvm, brew doctor) synchron bei jedem interaktiven Shell-Start aus.

Fehlerbehebung

Fehler / Symptom	Ursache	Lösung
zsh: Befehl nicht gefunden: ... nach Bearbeiten von .zshrc	Syntaxfehler in .zshrc oder $PATH-Zuweisung überschrieben statt vorangestellt	Pfade korrekt voranstellen: export PATH="$HOME/bin:$PATH" und source ~/.zshrc ausführen.
zsh compinit: unsichere Verzeichnisse, compaudit ausführen	Unsichere Dateiberechtigungen auf /usr/local/share/zsh	Führen Sie `compaudit
Zsh startet sehr langsam (> 500ms)	Synchrones nvm oder schwere Plugin-Initialisierung	Verwenden Sie Lazy Loading für nvm oder profilieren Sie mit zmodload zsh/zprof am Anfang der .zshrc und zprof am Ende.

Referenzen

• Zsh-Dokumentation