fzf (Fuzzy Finder) Cheatsheet¶

Installation¶

Plattform	Befehl
Ubuntu/Debian	`sudo apt update && sudo apt install fzf`
Fedora/RHEL	`sudo dnf install fzf`
Arch Linux	`sudo pacman -S fzf`
macOS (Homebrew)	`brew install fzf && $(brew --prefix)/opt/fzf/install`
Windows (Chocolatey)	`choco install fzf`
Windows (Scoop)	`scoop install fzf`
Windows (winget)	`winget install fzf`
From Source	`git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf && ~/.fzf/install`
`# Bash echo '[ -f ~/.fzf.bash ] && source ~/.fzf.bash' >> ~/.bashrc # Zsh echo '[ -f ~/.fzf.zsh ] && source ~/.fzf.zsh' >> ~/.zshrc`

Grundlegende Befehle¶

Befehl	Beschreibung
`fzf`	Interaktive Fuzzy-Suche auf stdin oder Dateien starten
`vim $(fzf)`	Datei in vim finden und öffnen
`ls \ \| fzf`	Unscharfe Suche durch ls Ausgabe
`fzf --multi`	Aktivieren Sie den Mehrfachauswahl-Modus (verwenden Sie Tab zum Auswählen)
`fzf --preview 'cat {}'`	Dateivorschau während des Browsens anzeigen
`fzf --reverse`	Ergebnisse von oben nach unten anzeigen
`fzf --height 40%`	Finder-Höhe auf 40% der Bildschirmgröße setzen
`fzf --border`	Rahmen um Finder-Oberfläche hinzufügen
`fzf --prompt "Select: "`	Passen Sie die Eingabeaufforderung an
`fzf --exact`	Verwende exaktes Matching anstelle von fuzzy Matching
`fzf +i`	Groß-/Kleinschreibung-sensitive Suche aktivieren
`fzf --inline-info`	Informationen inline mit der Eingabeaufforderung anzeigen
`find . -name "*.py" \ \| fzf`	Bestimmte Dateitypen finden und filtern
`ps aux \ \| fzf`	Laufende Prozesse interaktiv durchsuchen
`history \ \| fzf`	Suche in Befehlsverlauf
## Standard-Tastenkombinationen

Tastenbelegung	Aktion
`Ctrl+T`	Ausgewählte Dateien/Verzeichnisse in Befehlszeile einfügen
`Ctrl+R`	Suchverlauf der Befehle durchsuchen und ausgewählten Befehl einfügen
`Alt+C`	Fuzzy-Verzeichnis finden und hinein wechseln
`**<Tab>`	Trigger fuzzy completion (e.g., `vim **<Tab>`)
`Ctrl+J` / `Ctrl+N`	Cursor nach unten bewegen
`Ctrl+K` / `Ctrl+P`	Cursor nach oben bewegen
`Enter`	Artikel auswählen und beenden
`Tab`	Element im Mehrfachauswahl-Modus auswählen/abwählen
`Shift+Tab`	Element im Mehrfachauswahl-Modus abwählen
`Ctrl+C` / `Esc`	Abbrechen und beenden
## Erweiterte Nutzung

Befehl	Beschreibung
`fzf --preview 'bat --color=always {}'`	Vorschau mit Syntaxhervorhebung mit bat
`fzf --preview-window=right:50%`	Positionsvorschau-Fenster rechts mit 50% Breite
`fzf --preview-window=hidden`	Beginnen Sie mit ausgeblendetem Vorschau (umschalten mit Strg+/)
`fzf --bind 'ctrl-e:execute(vim {})'`	Führe vim auf dem ausgewählten Element mit Strg+E aus
`fzf --bind 'ctrl-y:execute-silent(echo {} \ \| pbcopy)'`	Auswahl lautlos in Zwischenablage kopieren
`fzf --delimiter=' ' --nth=2..`	Suche nur ab dem 2. Feld
`fzf --header="Select file to edit"`	Kopftext zum Finder hinzufügen
`fzf --color=dark`	Dunkles Farbschema verwenden
`fzf --query="initial"`	Vorausgefüllte Suchanfrage
`fzf --select-1 --exit-0`	Automatisch auswählen, wenn ein Treffer, beenden wenn keine vorhanden
`fzf --expect=ctrl-d,ctrl-e`	Verschiedene Exit-Codes für verschiedene Schlüssel zurückgeben
`fzf --print-query`	Drucke Abfragezeichenfolge auch wenn keine Übereinstimmung
`fzf --cycle`	Ergebniszyklusierung aktivieren (Umlauf)
`fzf --no-mouse`	Mouse-Unterstützung deaktivieren
`fzf --algo=v2`	Verwenden Sie einen schnelleren Matching-Algorithmus für große Datensätze
`fzf --tac`	Eingabereihenfolge umkehren
`fzf --no-sort`	Sortierung deaktivieren, Eingabereihenfolge beibehalten
`fzf --border=rounded`	Abgerundeten Rahmenstil verwenden
`fzf --sync`	Verwenden Sie synchrones Filtern (kein async)
`fzf --scroll-off=5`	Ausgewähltes Element 5 Zeilen vom Rand entfernt halten
## Konfiguration

Umgebungsvariablen¶

Primäre Konfigurationsdatei: ~/.bashrcoder ~/.zshrc

# Default command for finding files (using fd)
export FZF_DEFAULT_COMMAND='fd --type f --hidden --follow --exclude .git'

# Default options applied to all fzf invocations
export FZF_DEFAULT_OPTS='
  --height 40%
  --layout=reverse
  --border
  --inline-info
  --preview "bat --style=numbers --color=always --line-range :500 {}"
  --preview-window=right:50%:hidden
  --bind "ctrl-/:toggle-preview"
  --bind "ctrl-y:execute-silent(echo {} | pbcopy)"
'

# Ctrl+T configuration (file finder)
export FZF_CTRL_T_COMMAND="$FZF_DEFAULT_COMMAND"
export FZF_CTRL_T_OPTS="
  --preview 'bat --color=always --line-range :50 {}'
  --bind 'ctrl-/:change-preview-window(down|hidden|)'
"

# Alt+C configuration (directory finder)
export FZF_ALT_C_COMMAND='fd --type d --hidden --follow --exclude .git'
export FZF_ALT_C_OPTS="
  --preview 'tree -C {} | head -50'
"

# Ctrl+R configuration (history search)
export FZF_CTRL_R_OPTS="
  --preview 'echo {}'
  --preview-window up:3:hidden:wrap
  --bind 'ctrl-/:toggle-preview'
  --bind 'ctrl-y:execute-silent(echo -n {2..} | pbcopy)+abort'
  --color header:italic
  --header 'Press CTRL-Y to copy command into clipboard'
"

Farbschema-Konfiguration¶

# Monokai theme
export FZF_DEFAULT_OPTS='
  --color=bg+:#293739,bg:#1B1D1E,border:#808080
  --color=spinner:#E6DB74,hl:#7E8E91,fg:#F8F8F2
  --color=header:#7E8E91,info:#A6E22E,pointer:#A6E22E
  --color=marker:#F92672,fg+:#F8F8F2,prompt:#F92672,hl+:#F92672
'

# Dracula theme
export FZF_DEFAULT_OPTS='
  --color=fg:#f8f8f2,bg:#282a36,hl:#bd93f9
  --color=fg+:#f8f8f2,bg+:#44475a,hl+:#bd93f9
  --color=info:#ffb86c,prompt:#50fa7b,pointer:#ff79c6
  --color=marker:#ff79c6,spinner:#ffb86c,header:#6272a4
'

# Nord theme
export FZF_DEFAULT_OPTS='
  --color=fg:#e5e9f0,bg:#3b4252,hl:#81a1c1
  --color=fg+:#e5e9f0,bg+:#434c5e,hl+:#81a1c1
  --color=info:#eacb8a,prompt:#bf6069,pointer:#b48dac
  --color=marker:#a3be8b,spinner:#b48dac,header:#a3be8b
'

Häufige Anwendungsfälle¶

Anwendungsfall: Git-Branch-Auswahl¶

# Interactive git branch selection
git checkout $(git branch -a | fzf | sed 's/^[ *]*//' | sed 's/remotes\/origin\///')

# Or create an alias
alias gcb='git checkout $(git branch | fzf | sed "s/^[ *]*//")'

Anwendungsfall: Prozess beenden¶

# Find and kill process interactively
kill -9 $(ps aux | fzf | awk '{print $2}')

# Or create a function
fkill() {
  local pid
  pid=$(ps aux | sed 1d | fzf -m | awk '{print $2}')
  if [ "x$pid" != "x" ]; then
    echo $pid | xargs kill -${1:-9}
  fi
}

Anwendungsfall: SSH-Host-Auswahl¶

# Select from SSH config hosts
ssh $(grep "^Host" ~/.ssh/config | grep -v "[?*]" | cut -d " " -f2- | fzf)

# Or create an alias
alias fssh='ssh $(grep "^Host" ~/.ssh/config | grep -v "[?*]" | cut -d " " -f2- | fzf)'

# Create a function to track and jump to directories
fcd() {
  local dir
  dir=$(find ${1:-.} -path '*/\.*' -prune -o -type d -print 2> /dev/null | fzf +m) && cd "$dir"
}

# Jump to frequently used directories (requires z or autojump)
fz() {
  local dir
  dir=$(z -l 2>&1 | fzf --height 40% --nth 2.. --reverse --inline-info +s --tac --query "${*}" | sed 's/^[0-9,.]* *//')
  cd "$dir"
}

Anwendungsfall: Docker-Container-Verwaltung¶

# Select and attach to running container
docker exec -it $(docker ps | fzf | awk '{print $1}') /bin/bash

# Select and stop containers
docker stop $(docker ps -a | fzf -m | awk '{print $1}')

# Select and remove images
docker rmi $(docker images | fzf -m | awk '{print $3}')

Anwendungsfall: Umgebungsvariablen-Betrachter¶

# Browse and copy environment variables
env | fzf --preview 'echo {}' --preview-window=up:3:wrap \
  --bind 'enter:execute(echo {} | cut -d= -f2 | pbcopy)+abort'

Anwendungsfall: Log-Datei-Analyse¶

# Search through log files with preview
find /var/log -type f 2>/dev/null | fzf \
  --preview 'tail -100 {}' \
  --bind 'enter:execute(less {})'

# Search log content
grep -r "ERROR" /var/log 2>/dev/null | fzf \
  --delimiter=: \
  --preview 'bat --color=always {1} --highlight-line {2}' \
  --preview-window +{2}-/2

Bewährte Praktiken¶

Verwenden mit fd oder ripgrep: Ersetzen findmit fdfür schnellere Dateisuche: export FZF_DEFAULT_COMMAND='fd --type f'
Vorschau standardmäßig aktivieren: Vorschaufenster hinzufügen, um Dateiinhalte vor der Auswahl zu sehen, was die Genauigkeit verbessert und Fehler reduziert
Shell-Aliase erstellen: Benutzerdefinierte Aliase für häufige Arbeitsabläufe (Git-Operationen, SSH-Verbindungen, Prozessverwaltung) erstellen, um Produktivität zu maximieren
Mit anderen Tools kombinieren: fzf mitbatfür Syntax-Highlighting,treefür Verzeichnisvorschauen unddeltafür Git-Diffs
Multi-Select klug nutzen: Aktivieren --multiModus, wenn Sie auf mehrere Elemente arbeiten müssen (Dateien löschen, mehrere Git-Dateien auschecken)
Tastenkombinationen nutzen: Passen Sie --bindOptionen an, um Shortcuts für häufige Aktionen zu erstellen (in Editor öffnen, in Zwischenablage kopieren, Befehle ausführen)
Für große Datensätze optimieren: Verwenden Sie --algo=v2und erwägen Sie --syncModus für sehr große Dateilisten zur Leistungsverbesserung
Geeignete Höhen festlegen: Verwenden Sie --height 40%oder ähnliches, um eine vollständige Bildschirmübernahme zu vermeiden und den Kontext Ihrer aktuellen Arbeit beizubehalten
Farbschemata konfigurieren: Passen Sie fzf-Farben an Ihr Terminal-Design an für bessere visuelle Integration und reduzierte Augenbelastung
Feldtrennzeichen verwenden: Beim Parsen strukturierter Ausgaben (wie psoder docker), verwenden Sie --delimiterund --nth, um spezifische Spalten zu durchsuchen

Fehlerbehebung¶

Problem	Lösung
Key bindings not working	Run the install script: `~/.fzf/install` or source the shell integration file in your RC file
Slow performance with large file lists	Use `fd` or `ripgrep` instead of `find`: `export FZF_DEFAULT_COMMAND='fd --type f'` and consider `--algo=v2`
Preview not showing file contents	Ensure preview command is correct and file is readable. Try `--preview 'cat {}'` or install `bat` for better previews
Colors not displaying correctly	Check terminal supports 256 colors. Use `--color=16` for basic color support or adjust color scheme
Command not found after installation	Add fzf to PATH or restart shell. For Homebrew: ensure `/usr/local/bin` or `/opt/homebrew/bin` is in PATH
Unicode characters not rendering	Ensure terminal and locale support UTF-8: `export LC_ALL=en_US.UTF-8` and use a Unicode-capable font
fzf consuming too much memory	Reduce input size or use `--sync` mode. Consider filtering input before piping to fzf
Preview window not updating	Use `--preview-window=follow` for auto-scrolling or toggle preview with `Ctrl+/` to refresh
Cannot select items with mouse	Mouse support may be disabled. Remove `--no-mouse` option or click outside fzf and retry
Completion not working with `**<Tab>`	Ensure shell integration is loaded. Check `~/.fzf.bash` or `~/.fzf.zsh` is sourced in your RC file
## Suchsyntax

Syntax	Beschreibung	Beispiel
`term`	Fuzzy Match	`fzf` with input "abc" matches "a_b_c.txt"
`'term`	Exakte Übereinstimmung (Einzelanführungszeichen-Präfix)	`'abc` matches only "abc" exactly
`^term`	Präfix exakte Übereinstimmung	`^abc` matches "abc..." but not "zabc"
`term$`	Suffix exakte Übereinstimmung	`abc$` matches "...abc" but not "abcz"
`!term`	Inverse Match (Ausschluss)	`!test` excludes lines with "test"
`term1 term2`	UND Übereinstimmung (beide erforderlich)	`foo bar` matches lines with both terms
`term1 \ \| term2`	OR-Übereinstimmung (entweder erforderlich)	`foo \ \| bar` matches lines with either term
## Nützliche Shell-Funktionen```bash
# Open file in editor with preview
fe() {
local files
files=$(fzf --query="$1" --multi --select-1 --exit-0 \
--preview 'bat --color=always --line-range :500 {}')
[[ -n "$files" ]] && ${EDITOR:-vim} "$"
}

Change to directory with preview¶

fcd() { local dir dir=$(fd --type d --hidden --follow --exclude .git | fzf \ --preview 'tree -C {} | head -100') && cd "$dir" }

Git commit browser¶

fgc() { git log --oneline --color=always | fzf --ansi \ --preview 'git show --color=always {1}' \ --bind 'enter:execute(git show {1} | less -R)' }

Browse and install packages (Debian/Ubuntu)¶

fap() { apt-cache search . | fzf --multi --preview 'apt-cache show {1}' | \ awk '{print $1}' | xargs -ro sudo apt install } ```