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`
`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`
`ps aux \	fzf`
`history \	fzf`

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)‘`
`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)

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} ”${files[@]}” }

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 }