Vai al contenuto

fzf (Fuzzy Finder) Cheat Sheet

Installazione

Piattaforma Comando
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
Integrazione Shell Post-Installazione: 
# Bash
echo '[ -f ~/.fzf.bash ] && source ~/.fzf.bash' >> ~/.bashrc

# Zsh
echo '[ -f ~/.fzf.zsh ] && source ~/.fzf.zsh' >> ~/.zshrc

Comandi Base

Comando Descrizione
fzf Avvia un fuzzy finder interattivo su stdin o file
vim $(fzf) Trova e apri file in vim
ls \ | fzf Ricerca fuzzy nell'output di ls
fzf --multi Abilita la modalità di selezione multipla (usa Tab per selezionare)
fzf --preview 'cat {}' Mostra anteprima file durante la navigazione
fzf --reverse Visualizza i risultati dall'alto verso il basso
fzf --height 40% Imposta l'altezza del finder al 40% dello schermo
fzf --border Aggiungi un bordo intorno all'interfaccia del finder
fzf --prompt "Select: " Personalizza il prompt di input
fzf --exact Utilizzare la corrispondenza esatta invece della corrispondenza approssimativa
fzf +i Abilita ricerca sensibile alle maiuscole/minuscole
fzf --inline-info Visualizza informazioni inline con prompt
find . -name "*.py" \ | fzf Trova e filtra tipi di file specifici
ps aux \ | fzf Cerca processi in esecuzione in modo interattivo
history \ | fzf Cerca nella cronologia dei comandi
## Associazioni di Tasti Predefinite
Associazione di Tasti Azione
Ctrl+T Incolla file/directory selezionati nella riga di comando
Ctrl+R Cerca nella cronologia dei comandi e incolla il comando selezionato
Alt+C Trova directory in modo fuzzy e cd al suo interno
**<Tab> Trigger fuzzy completion (e.g., vim **<Tab>)
Ctrl+J / Ctrl+N Sposta cursore verso il basso
Ctrl+K / Ctrl+P Sposta cursore verso l'alto
Enter Seleziona elemento ed esci
Tab Seleziona/deseleziona elemento in modalità multi-selezione
Shift+Tab Deseleziona elemento in modalità selezione multipla
Ctrl+C / Esc Annulla ed esci
## Utilizzo Avanzato
Comando Descrizione
fzf --preview 'bat --color=always {}' Anteprima con evidenziazione della sintassi utilizzando bat
fzf --preview-window=right:50% Posiziona la finestra di anteprima a destra al 50% di larghezza
fzf --preview-window=hidden Inizia con l'anteprima nascosta (attiva/disattiva con Ctrl+/)
fzf --bind 'ctrl-e:execute(vim {})' Esegui vim sull'elemento selezionato con Ctrl+E
fzf --bind 'ctrl-y:execute-silent(echo {} \ | pbcopy)' Copia selezione negli appunti in modo silenzioso
fzf --delimiter=' ' --nth=2.. Cerca solo dal 2° campo in poi
fzf --header="Select file to edit" Aggiungi testo di intestazione a finder
fzf --color=dark Usa lo schema di colori scuro
fzf --query="initial" Pre-popolare query di ricerca
fzf --select-1 --exit-0 Selezione automatica se c'è una corrispondenza, esci se non ce ne sono
fzf --expect=ctrl-d,ctrl-e Restituisci codici di uscita diversi per chiavi diverse
fzf --print-query Stampa la stringa di query anche se non c'è corrispondenza
fzf --cycle Abilita scorrimento risultati (avvolgimento)
fzf --no-mouse Disabilita supporto mouse
fzf --algo=v2 Utilizzare un algoritmo di corrispondenza più veloce per set di dati di grandi dimensioni
fzf --tac Inverti l'ordine dell'input
fzf --no-sort Disabilita l'ordinamento, mantieni l'ordine di input
fzf --border=rounded Utilizzare lo stile di bordo arrotondato
fzf --sync Utilizzare filtri sincroni (nessun async)
fzf --scroll-off=5 Mantieni l'elemento selezionato a 5 righe dal bordo
## Configurazione

Variabili di Ambiente

File di Configurazione Principale: ~/.bashrco ~/.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'
"

Configurazione Schema Colori

# 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
'

Casi d'Uso Comuni

Caso d'Uso: Selezione Branch Git

# 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/^[ *]*//")'

Caso d'Uso: Terminare Processo

# 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
}

Caso d'Uso: Selezione Host SSH

# 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)'

Caso d'Uso: Navigazione Directory con Cronologia

# 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"
}

Caso d'Uso: Gestione Container Docker

# 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}')

Caso d'Uso: Visualizzatore Variabili di Ambiente

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

Caso d'Uso: Analisi File di Log

# 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

Migliori Pratiche

  • Utilizzare con fd o ripgrep: Sostituire findcon fdper una ricerca file più veloce: export FZF_DEFAULT_COMMAND='fd --type f'

  • Abilitare l'anteprima per impostazione predefinita: Aggiungere finestre di anteprima per visualizzare il contenuto dei file prima della selezione, migliorando precisione e riducendo errori

  • Creare alias shell: Costruire alias personalizzati per flussi di lavoro frequenti (operazioni git, connessioni SSH, gestione processi) per massimizzare la produttività

  • Combinare con altri strumenti: Integrare fzf conbatper l'evidenziazione della sintassi,treeper l'anteprima delle directory, edeltaper i git diff

  • Usa la selezione multipla con saggezza: Abilita--multila modalità quando devi operare su più elementi (eliminare file, fare checkout di più file git)

  • Sfrutta le associazioni di tasti: Personalizza--bindle opzioni per creare scorciatoie per azioni comuni (aprire nell'editor, copiare negli appunti, eseguire comandi)

  • Ottimizza per set di dati di grandi dimensioni: Usa--algo=v2e considera--syncla modalità per elenchi di file molto grandi per migliorare le prestazioni

  • Imposta altezze appropriate: Usa--height 40%o simili per evitare l'occupazione dell'intero schermo, mantenendo il contesto del tuo lavoro corrente

  • Configura schemi di colori: Abbina i colori di fzf al tema del tuo terminale per una migliore integrazione visiva e ridurre l'affaticamento degli occhi

  • Usa delimitatori di campi: Quando analizzi output strutturati (comepsodocker), usa--delimitere--nthper cercare colonne specifiche

Risoluzione dei problemi

Problema Soluzione
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
## Sintassi di ricerca
Sintassi Descrizione Esempio
term Fuzzy match fzf with input "abc" matches "a_b_c.txt"
'term Corrispondenza esatta (prefisso con apice singolo) 'abc matches only "abc" exactly
^term Corrispondenza esatta con prefisso ^abc matches "abc..." but not "zabc"
term$ Corrispondenza esatta del suffisso abc$ matches "...abc" but not "abcz"
!term Corrispondenza inversa (escludi) !test excludes lines with "test"
term1 term2 E corrispondenza (entrambi richiesti) foo bar matches lines with both terms
term1 \ | term2 Corrispondenza OR (uno dei due richiesto) foo \ | bar matches lines with either term
## Funzioni Shell Utili```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 } ```