fd
Prefira fd a find para buscas no sistema de arquivos.
fd é mais rápido em árvores grandes,
tem padrões mais sensatos
(respeita .gitignore, uso inteligente de maiúsculas/minúsculas, regex por padrão),
e uma CLI mais ergonômica.
Documentação oficial:
https://github.com/sharkdp/fd
(README + fd --help).
Verifique qualquer forma não trivial contra o manual antes de confiar nela.
Porquê
- Travessia paralela de diretórios —
notavelmente mais rápido que
findem repositórios grandes. - Padrões sensatos prontos para uso:
entradas ocultas ignoradas,
.gitignore/.ignore/.fdignorerespeitados quando dentro de um repositório git, uso inteligente de maiúsculas/minúsculas (sem distinção, a menos que o padrão tenha uma letra maiúscula), padrões são regex por padrão. - O padrão corresponde ao nome do arquivo por padrão,
não ao caminho completo —
fd foofaz o quefind . -iname '*foo*'faz, sem o ritual de curingas e aspas. - Execução paralela
-x, saída separada por nulo (-0), e um único conjunto de opções que se compõem sem ginástica de-print/-prune.
Regra
fd PADRÃO [CAMINHO]
O primeiro argumento posicional é o padrão;
o segundo é a raiz da busca
(padrão é o diretório atual).
Um primeiro argumento em forma de caminho (contendo /) não é um caminho —
use fd . CAMINHO ou fd --full-path PADRÃO.
Substituições diretas
| Não use | Use |
|---|---|
find . -name 'foo*' | fd '^foo' |
find . -iname '*.md' | fd -e md |
find . -type f -name foo | fd -t f foo |
find . -type d -name node_modules | fd -t d node_modules |
find . -type l | fd -t l |
find . -name '*.txt' -delete | fd -e txt -X rm |
find . -name '*.txt' -exec rm {} \; | fd -e txt -x rm |
find . -name node_modules -prune | fd -E node_modules |
find . -size +100M | fd -S +100mi |
find . -mtime -7 | fd --changed-within 7d |
find . -mtime +7 | fd --changed-before 7d |
find . -name '*.go' -print0 | xargs -0 wc -l | fd -e go -0 | xargs -0 wc -l |
find /etc -name passwd | fd passwd /etc |
find / -name foo | fd -u foo / |
Para uma correspondência exata com find -size,
use os sufixos binários
(ki, mi, gi) —
-S +100m é 100 * 10^6 bytes,
-S +100mi é 100 * 2^20 bytes.
Para buscas com find / que também devem descer em diretórios ocultos e
.gitignore, adicione -u(atalho para--no-ignore --hidden`).
Expressões idiomáticas
Correspondência por extensão (uma ou várias):
fd -e md
fd -e h -e cpp
Modo glob para padrões no estilo shell
(-g para que ** e * signifiquem o usual):
fd -g '**/*.test.ts'
fd -g 'libc.so' /usr
Correspondência contra o caminho completo, não apenas o nome do arquivo:
fd --full-path 'src/.*\.proto$'
Incluir entradas ocultas
(.git, .vscode, etc.)
mas manter as regras de .gitignore:
fd -H pre-commit
Desconsiderar regras de .gitignore mas manter entradas ocultas ocultas:
fd -I node_modules
Buscar em todos os lugares — tanto ocultos quanto ignorados:
fd -u PADRÃO
Excluir caminhos (sintaxe glob, substitui toda regra de ignore, repetível):
fd -E .git -E '*.bak' PADRÃO
Limitar profundidade:
fd -d 2 -t d
Combinar múltiplos padrões obrigatórios (todos devem corresponder ao nome do arquivo, regex por padrão):
fd 'foo' --and 'bar' --and 'baz'
Executar por resultado
(paralelo, substituição {}, sem terminador \;):
fd -e jpg -x convert {} {.}.png
Executar uma vez com todos os resultados como argumentos
(ferramentas em lote como wc, clang-format, rg):
fd -e rs -X wc -l
Encanar saída separada por nulo para outras ferramentas:
fd -e go -0 | xargs -0 wc -l
Armadilhas
- O primeiro argumento posicional é o padrão, não o caminho.
fd /etc/passwdinterpreta/etc/passwdcomo uma regex com/e gera erro com a sugestão de usarfd . /etc/passwdou--full-path. - A busca padrão exclui entradas ocultas e respeitadas por
.gitignore. Ao procurar algo dentro denode_modulesou.git, adicione-H -I(ou-u) ou a lista de resultados estará vazia pelo motivo errado. --execparaleliza por padrão. A ordem da saída é não determinística. Passe-j 1(ou--threads 1) quando a execução serial for necessária.- Padrões são regex por padrão.
Um
.simples corresponde a qualquer caractere; para um.fooliteral, ancore-o ('\.foo$') ou passe-F/--fixed-strings. - Sufixos de tamanho são decimais SI por padrão.
-S +100mé100 MB(10^6bytes porm); usemi/ki/gipara unidades binárias ao corresponder exatamente à semântica defind -size.
Fallback para find
fd nem sempre está disponível —
imagens mínimas de CI,
servidores bloqueados,
imagens base de contêiner sem pacotes extras.
Teste com command -v e recorra a find:
if command -v fd >/dev/null; then
fd -e log -t f -X rm
else
find . -type f -name '*.log' -exec rm {} +
fi
Para um snippet único em um ambiente local controlado,
use fd diretamente.
Mude para find incondicionalmente apenas quando o host alvo for conhecido
por não ter fd
(por exemplo, um contêiner Alpine mínimo sem fd na imagem).
Não instale fd automaticamente apenas para satisfazer esta habilidade —
o fallback é a resposta correta quando ele está ausente.
Instalando fd
- macOS:
brew install fd - Debian/Ubuntu:
apt install fd-find— o binário se chamafdfindpara evitar conflito de nomes (alias fd=fdfindé a solução padrão). - Fedora:
dnf install fd-find - Arch:
pacman -S fd - Alpine:
apk add fd - Binários pré-compilados e outras plataformas: https://github.com/sharkdp/fd/releases
Quando o mise gerencia as ferramentas do host,
o nome curto do registro fd resolve para aqua:sharkdp/fd —
instale com mise use -g fd@<versão>
(fixado, conforme a habilidade mise do projeto).
Não use o backend ubi: —
a habilidade mise o desabilita.
Escopo
Aplica-se sempre que um snippet de shell pesquisa o sistema de arquivos:
- Invocações da ferramenta
Bash. - Snippets em
SKILL.md/README.md/ docs. - Scripts em
scripts/. - Receitas de Makefile.
- Configurações de CI.
- Instruções de instalação.
Se você encontrar uma invocação de find enquanto edita um arquivo,
substitua-a pela forma equivalente de fd
(mais o fallback find quando o snippet precisar ser executado em um host que
pode não ter fd)
como parte da mesma edição.