fd - Alternativa Rápida y Amigable para Find
Instalación
| Platform | Comando |
|---|
| Ubuntu/Debian | sudo apt install fd-find (binary: fdfind) |
| Arch Linux | sudo pacman -S fd |
| Fedora/RHEL | sudo dnf install fd-find |
| Alpine Linux | apk add fd |
| macOS (Homebrew) | brew install fd |
| macOS (MacPorts) | sudo port install fd |
| Windows (Scoop) | scoop install fd |
| Windows (Chocolatey) | choco install fd |
| Windows (Winget) | winget install sharkdp.fd |
| Cargo (All platforms) | cargo install fd-find |
| Snap | sudo snap install fd |
Comandos Básicos
| Comando | Descripción |
|---|
fd filename | Buscar archivos/directorios que coincidan con “filename” |
fd pattern /path | Buscar patrón en directorio específico |
fd -e txt | Encontrar todos los archivos con extensión .txt |
fd -e js -e ts | Encontrar archivos con múltiples extensiones (.js o .ts) |
fd -t f pattern | Encontrar solo archivos (no directorios) |
fd -t d dirname | Encontrar solo directorios |
fd -t x | Encontrar solo archivos ejecutables |
fd -t l | Encontrar solo enlaces simbólicos |
fd -s Pattern | Búsqueda sensible a mayúsculas y minúsculas (por defecto es insensible a mayúsculas y minúsculas) |
fd -d 3 pattern | Limitar la profundidad de búsqueda a 3 niveles |
fd -H pattern | Incluir archivos ocultos en la búsqueda |
fd -I pattern | No respetar las reglas de .gitignore |
fd -a pattern | Mostrar rutas absolutas en lugar de rutas relativas |
fd -l pattern | Show detailed listing (like ls -l) |
fd -0 pattern | Use null separator (for piping to xargs -0) |
Uso Avanzado
| Comando | Descripción |
|---|
fd '^test.*\.js$' | Usar patrón regex (archivos que comienzan con “test”, que terminan con .js) |
fd -g '*.{js,ts}' | Utiliza patrones glob en lugar de regex |
fd -F 'exact.string' | Búsqueda de cadena fija (sin interpretación de regex) |
fd -E node_modules -E '*.tmp' pattern | Excluir patrones específicos de la búsqueda |
fd --no-ignore pattern | No utilices archivos .gitignore, .fdignore o .ignore |
fd -L pattern | Seguir enlaces simbólicos durante la búsqueda |
fd --changed-within 2d | Archivos modificados en los últimos 2 días |
fd --changed-before 30d | Archivos no modificados en los últimos 30 días |
fd --size +100m | Archivos mayores de 100MB |
fd --size +10m --size -100m | Archivos entre 10MB y 100MB |
fd --owner username | Archivos propiedad de usuario específico |
fd --max-results 100 | Limitar la salida a 100 resultados |
fd -x rm {} | Ejecutar comando en cada resultado (eliminar archivos) |
fd -X convert {} {.}.png | Ejecutar comando con múltiples argumentos (conversión por lotes) |
fd --color never pattern | Deshabilitar salida coloreada |
fd --strip-cwd-prefix pattern | Remove ./ prefix from results |
fd -H -t d "^\." | Encontrar directorios ocultos (que comienzan con punto) |
fd -t f -x du -h {} | Mostrar tamaños de archivos para todas las coincidencias |
fd pattern --threads 1 | Usar single thread (para debugging) |
fd --base-directory /path pattern | Cambiar directorio base para búsqueda |
Configuración
Archivos de Configuración
Ubicaciones de archivos de ignorados globales:
- Linux/macOS:
~/.config/fd/ignoreo~/.fdignore
- Windows:
%APPDATA%\fd\ignore
Específico del proyecto:.fdignoreen la raíz del proyecto
Ejemplo de Archivo .fdignore
# Ignore dependency directories
node_modules/
vendor/
target/
# Ignore build outputs
build/
dist/
*.o
*.pyc
# Ignore IDE directories
.idea/
.vscode/
*.swp
# Ignore log files
*.log
logs/
# Ignore temporary files
*.tmp
*~
.DS_Store
# Ignore specific paths
/cache/
/tmp/
Variables de Entorno
# Set default options for all fd commands
export FD_OPTS="--hidden --follow --exclude .git"
# Control colorization (fd respects LS_COLORS)
export LS_COLORS="di=34:ln=35:ex=31:*.txt=33"
Alias Útiles
# Add to ~/.bashrc or ~/.zshrc
# Search including hidden files
alias fdh='fd -H'
# Search ignoring .gitignore
alias fda='fd -I'
# Find large files
alias fdl='fd --size +100m'
# Find recent files (last 24 hours)
alias fdr='fd --changed-within 1d'
# Find and preview with fzf and bat
alias fdf='fd -t f | fzf --preview "bat --color=always {}"'
# Find and edit with vim
alias fdv='fd -t f | fzf | xargs -r vim'
Casos de Uso Comunes
Caso de Uso 1: Limpiar Artefactos de Compilación
# Remove all Python compiled files
fd -e pyc -e pyo -x rm {}
# Remove all node_modules directories (up to 2 levels deep)
fd -t d -d 2 '^node_modules$' -x rm -rf {}
# Clean old log files (older than 30 days)
fd -e log --changed-before 30d -x rm {}
# Remove all temporary files
fd -g '*.tmp' -g '*~' -g '*.swp' -x rm {}
Caso de Uso 2: Búsqueda y Análisis de Código
# Find all JavaScript/TypeScript files modified in last week
fd -e js -e ts -e jsx -e tsx --changed-within 7d
# Count lines of code in Rust project
fd -e rs -x wc -l {} | awk '{sum+=$1} END {print sum}'
# Find all TODO comments in Python files
fd -e py -x grep -Hn "TODO:" {}
# Find largest source files
fd -e java -e kt -x du -h {} | sort -hr | head -20
# Find files containing specific function name
fd -e cpp -e hpp -x grep -l "myFunction" {}
Caso de Uso 3: Gestión de Archivos de Registro
# Find and compress logs older than 7 days
fd -e log --changed-before 7d -x gzip {}
# Search for errors in recent logs
fd -e log --changed-within 1d -x grep -i "error" {} \;
# Find large log files (over 100MB)
fd -e log --size +100m -l
# Archive old logs to separate directory
fd -e log --changed-before 30d -x mv {} /archive/logs/
Caso de Uso 4: Gestión de Docker y Contenedores
# Find all Dockerfiles in project
fd -g '*Dockerfile*' -g 'Dockerfile.*'
# Find all docker-compose files
fd -g 'docker-compose*.yml' -g 'docker-compose*.yaml'
# Find and validate Dockerfiles
fd '^Dockerfile$' -x docker build --dry-run -f {} .
# Find container-related configs
fd -e yml -e yaml -x grep -l "kind:" {} \;
Caso de Uso 5: Auditoría de Seguridad y Permisos
# Find world-writable files (security risk)
fd -t f -x sh -c 'test -w {} && ls -l {}'
# Find SUID/SGID binaries
fd -t x -x sh -c 'test -u {} -o -g {} && ls -l {}'
# Find files with passwords in name
fd -i password -i passwd -i secret
# Find configuration files with potential secrets
fd -g '*.conf' -g '*.cfg' -g '*.ini' -x grep -i "password\|secret\|key" {}
# Find SSH keys
fd -g 'id_rsa*' -g 'id_ed25519*' -H
Mejores Prácticas
- Usar archivos
.fdignore: Crear patrones de ignorados específicos del proyecto para acelerar búsquedas y reducir ruido
- Aprovechar valores predeterminados inteligentes:
fdrespeta automáticamente
Would you like me to fill in the remaining placeholders with specific translations?.gitignore- usar-Isolo cuando necesites archivos ignorados
- Combinar con otras herramientas: Canalizar
fdsalida axargs,grep,fzfpara flujos de trabajo potentes
- Usar
-0conxargs: Siempre usarfd -0 | xargs -0para nombres de archivos con espacios o caracteres especiales
- Preferir
-xsobre tuberías: Usarfd -x command {}en lugar de canalizar axargspara un mejor rendimiento
- Establecer límites de profundidad: Usar
-dbandera en árboles de directorios grandes para prevenir recursión excesiva
- Usar filtros de tipo específicos: Filtrar por tipo (
-t f,-t d) temprano para reducir el espacio de búsqueda
- Crear alias: Configurar alias de shell para patrones de
fdfrecuentemente usados para ahorrar escritura
- Combinar filtros de tiempo y tamaño: Usar
--changed-withiny--sizejuntos para seleccionar archivos con precisión
- Probar patrones de regex: Usar probadores de regex en línea antes de búsquedas
fdcomplejas para verificar patrones
Resolución de problemas
| Problema | Solución |
|---|
Command not found: fd | On Debian/Ubuntu, binary is fdfind. Create symlink: ln -s $(which fdfind) ~/.local/bin/fd |
| Too many results | Use depth limit -d 3, exclude patterns -E node_modules, or filter by type -t f |
| Not finding hidden files | Add -H flag to include hidden files, or -HI to also ignore .gitignore rules |
| Search is too slow | Reduce depth with -d, exclude large directories with -E, or use --threads to control parallelism |
| Regex not matching | Remember fd uses case-insensitive search by default. Use -s for case-sensitive or -F for literal strings |
| Files in .gitignore showing up | This shouldn’t happen by default. Check for -I or --no-ignore flags in aliases or FD_OPTS |
| Special characters in filenames breaking commands | Use -0 with xargs -0 or use -x flag instead: fd pattern -x command {} |
| Cannot execute command on results | Check if using correct syntax: -x for individual execution, -X for batch execution |
| Color output in logs/files | Disable with --color never or redirect stderr: fd pattern 2>/dev/null |
| Permission denied errors | Redirect stderr to ignore: fd pattern 2>/dev/null or run with appropriate permissions |
| Not respecting .fdignore file | Ensure .fdignore is in project root or ~/.config/fd/ignore. Check file syntax matches .gitignore format |