fd命令速查
安装与基础搜索、类型与元数据过滤、忽略规则、输出格式、exec 批处理、与 rg 组合、实战场景与报错排查等 133 条命令
共 133 条命令 · 10 类场景 · 点击右侧图标可复制
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
fd --version | 查看版本,新版参数与老版略有差异 | |
fd -h | 常用参数摘要 | |
fd --help | 完整帮助,参数分组清晰 | |
apt install fd-find | Debian/Ubuntu 包名是 fd-find,命令为 fdfind | |
ln -s $(which fdfind) ~/.local/bin/fd | 给 Debian 系建软链,统一命令名 | |
yum install fd-find | RHEL/CentOS 安装 | |
brew install fd | macOS 安装 | |
cargo install fd-find | Rust 工具链安装,版本最新 | |
snap install fd | snap 安装 | |
fd --gen-completions bash > /etc/bash_completion.d/fd | 生成 shell 补全 | |
fd 默认遵守 gitignore 且跳过隐藏文件 | 这是它比 find 结果更干净的关键 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
fd main | 按文件名搜索,默认是正则匹配 | |
fd "main\.go$" | 用正则限定结尾,避免误匹配目录 | |
fd main src/ | 限定搜索目录 | |
fd -e go | 按扩展名搜索,最常用的写法 | |
fd -e go -e toml | 多个扩展名,参数可重复 | |
fd -e go main | 扩展名与名称条件叠加 | |
fd -F "a.b(c)" | 按字面量搜索,不解析正则元字符 | |
fd -i readme | 忽略大小写 | |
fd -s Main | 强制区分大小写 | |
fd -g "*.tar.gz" | glob 模式,适合处理复杂后缀 | |
fd -p "src/.*/test" | 匹配完整路径而不是文件名 | |
fd -a main | 输出绝对路径 | |
fd -d 2 | 限制最大搜索深度 | |
fd --min-depth 2 | 跳过浅层目录,只看深层结果 | |
fd -E node_modules | 排除目录或路径 | |
fd -E "*.min.js" -E dist | 多个排除规则叠加 | |
fd | 不带模式,等价列出所有可搜索文件 | |
fd -t f -e log | 只找普通文件,排除同名目录 | |
fd --max-results 20 | 限制输出条数,避免刷屏 | |
fd -c main | 管道输出时也保留颜色 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
fd -t f pattern | 只搜普通文件 | |
fd -t d pattern | 只搜目录 | |
fd -t l | 只列符号链接 | |
fd -t x | 只列可执行文件 | |
fd -t e | 只列空文件或空目录 | |
fd -t f -t d build | 多个类型同时匹配 | |
fd -S +10M | 大于 10MB 的文件 | |
fd -S -1k | 小于 1KB 的文件 | |
fd --changed-within 2d | 最近两天修改过的文件 | |
fd --changed-within 30m | 最近半小时修改,排查刚动的文件 | |
fd --changed-before 2026-01-01 | 指定时间之前修改的文件 | |
fd -o root | 按属主过滤,找 root 拥有的文件 | |
fd -L pattern | 跟随符号链接深入搜索 | |
fd --one-file-system | 不跨文件系统,避免扫到挂载盘 | |
fd -t f -S +100M -x du -h {} | 找大文件并显示体积 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
fd -H pattern | 包含隐藏文件与隐藏目录 | |
fd -I pattern | 不遵守 .gitignore 等忽略规则 | |
fd -u pattern | 等价 -H -I,一次放开两层 | |
fd -uu pattern | 再放开一层,包含被忽略的隐藏文件 | |
fd --no-ignore-parent | 不读取上级目录的忽略文件 | |
fd --ignore-file ./myignore | 额外指定忽略规则文件 | |
fd -H -e env | 找 .env 类隐藏文件,注意敏感数据 | |
fd -u -e log | 把被忽略的日志文件也纳入搜索 | |
规则优先级:命令行 > .fdignore > .gitignore | 结果缺失时先怀疑忽略规则 | |
fd -H -I -d 1 | 只看当前层的全部条目,做目录盘点 | |
搜不到时先用 fd -u 验证 | 能搜到说明是被忽略规则挡住了 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
fd --print0 | 用 NUL 分隔结果,适配 xargs -0 | |
fd --strip-cwd-prefix | 去掉输出前缀 ./,便于直接拼命令 | |
fd --path-separator / | 统一路径分隔符,Windows 下常用 | |
fd --color never | 关闭颜色,写文件或解析时用 | |
fd --color always | less -R | 保留颜色分页查看 | |
fd --base-directory /var/log pattern | 指定搜索基准目录,输出仍是相对路径 | |
fd --max-results 50 pattern | 限制结果数量,交互场景更快 | |
fd pattern | head -20 | 管道截断,注意可能触发 SIGPIPE 警告 | |
fd pattern > list.txt | 结果落盘,交给后续脚本处理 | |
fd -0 | xargs -0 wc -l | 路径含空格时用 NUL 分隔才安全 | |
fd pattern --and -e go | 多个条件需同时满足时用 --and |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
fd -e log -x gzip | 每个结果执行一次命令,{} 默认追加在末尾 | |
fd -e go -x wc -l {} | 显式写占位符,位置更灵活 | |
fd -e go -X gofmt -w | 一次性把所有文件传给命令,减少进程数 | |
fd -e png -x mv {} {.}.jpg | {.} 表示去掉扩展名的路径,做批量改名 | |
fd -e tar.gz -x echo {/} | {/} 只取文件名,不带目录 | |
fd -e txt -x echo {//} | {//} 取所在目录 | |
fd -e txt -x echo {/.} | {/.} 取不带路径也不带扩展名的名字 | |
fd -t d -x rmdir {} | 删除空目录,稳妥于 rm -rf | |
fd -t d node_modules -X rm -rf | 批量清理依赖目录,执行前先不加 -X 预览 | |
fd -e go -x sh -c "gofmt -l {}" | 需要重定向或管道时用 sh -c 包一层 | |
fd -e log -X tar czf logs.tgz | 批量打包,注意参数顺序 | |
fd -x echo 先预览再执行 | 任何破坏性命令都先用 echo 验证结果集 | |
-x 是逐个执行,-X 是一次性传参 | 参数过多时 -X 可能超命令行长度上限 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
fd -e py | xargs rg -n "TODO" | 先按类型筛文件,再做内容检索 | |
fd -e yaml -X rg -n "image:" | 一次性把文件列表交给 rg,效率更高 | |
fd -0 -e log | xargs -0 gzip | 路径含空格时的安全写法 | |
fd -e md -x pandoc {} -o {.}.html | 批量文档转换 | |
fd -e jpg -x convert {} {.}.webp | 批量图片格式转换 | |
fd -e go -x go vet {} | 逐文件静态检查 | |
fd -t d -d 1 | xargs -I{} sh -c "echo {} && ls {} | wc -l" | 统计每个子目录的文件数 | |
fd -e json -X jq -e . > /dev/null | 批量校验 JSON 合法性 | |
fd | fzf --preview "head -20 {}" | 模糊选择文件并预览内容 | |
cd "$(fd -t d myproject | head -1)" | 用搜索结果直接切换目录 | |
fd -e sh -x shellcheck {} | 批量 shell 脚本检查 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
fd -H -t d -d 1 | 列出当前层全部目录,做项目结构盘点 | |
fd -t d node_modules -d 4 -x echo | 先预览将被清理的依赖目录 | |
fd -t d node_modules -X rm -rf | 确认后批量删除,释放磁盘 | |
fd -t f -S +500M | 找出超过 500MB 的大文件 | |
fd --changed-within 1d -e log | 看最近一天有变动的日志文件 | |
fd -e bak -e old -t f | 清理备份与临时文件前先列清单 | |
fd -e tar.gz -t f -X du -sh | 统计归档包总体积 | |
fd "^\.env" -H | 排查是否误提交环境变量文件 | |
fd -e go -t f | wc -l | 统计代码文件数量,评估仓库规模 | |
fd -t f -e lock | 列出全部锁文件,检查依赖管理混乱 | |
fd -t e | 找出空文件与空目录,清理前确认用途 | |
fd -e sh -t f -X chmod +x | 批量给脚本加执行权限 | |
fd -t d -d 1 -x echo {/} | 只看一级子目录名,做模块清单 | |
fd -e yaml -x sh -c "yq -e . {} > /dev/null || echo {} 有问题" | 批量校验 YAML 合法性 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
alias fda="fd -H" | 把包含隐藏文件设为常用别名 | |
alias fdd="fd -t d" | 只搜目录的别名 | |
alias fdx="fd -t x" | 只搜可执行文件 | |
~/.config/fd/ignore | 全局忽略文件,跨项目生效 | |
.fdignore | 项目级忽略文件,优先级高于 .gitignore | |
fd --ignore-file ~/.config/fd/ignore | 临时指定额外忽略规则 | |
fd -d 3 -E node_modules -E .git | 缩小范围是最有效的提速手段 | |
fd -t f -e go -d 5 | 限定类型与深度,大仓库也不慢 | |
fd -j 4 | 限制并发线程数,避免压满 CPU | |
fd --max-buffer-time 10 | 调整输出缓冲时间,大批量时可尝试 | |
fd 默认多线程并行遍历 | 比 find 快很多,且结果默认更干净 | |
别在生产根目录直接 fd / | 大范围遍历会拖慢磁盘,先限定路径 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
fd: unrecognized flag --xxx | 参数不存在或版本过低,用 fd -h 核对 | |
regex parse error | 模式被当作正则解析,含特殊字符时加 -F | |
[fd error]: Search path is not a directory | 路径参数写错,检查拼写 | |
Permission denied | 跳过无权限目录,必要时提升权限 | |
fd: command not found | Debian 系命令名是 fdfind,需建软链 | |
搜不到文件但确实存在 | 被忽略规则或隐藏文件过滤,加 -H 或 -u 验证 | |
-t 参数值非法 | 只能是 f/d/l/x/e 等,写错会直接报错 | |
-x 里 shell 元字符不生效 | 重定向与管道需要 sh -c 包一层 | |
-x 命令报参数错误 | 占位符未写或写错,注意 {} 与 {.} 的区别 | |
输出被截断或命令太长 | -X 一次传参可能超限,改回 -x 逐个执行 | |
Windows 下路径分隔符混乱 | 用 --path-separator / 统一输出 | |
结果顺序不稳定 | 多线程遍历本身无序,需要固定顺序就管道 sort | |
管道后颜色丢失 | 加 -c 或 --color always | |
fd 与 find 结果不同 | fd 默认遵守 gitignore 并跳过隐藏文件,属预期行为 | |
批量删除前务必先 echo 预览 | 误删的代价远大于多执行一条命令 |
运维常用组合
fd -t d node_modules -d 4 -x echo → 确认结果 → fd -t d node_modules -d 4 -X rm -rffd -e yaml -X rg -n "image:" → 只搜 yaml 里的镜像定义fd -t f -S +200M -x du -h {} | sort -h -r | head -20fd -e jpeg -x mv {} {.}.jpgfd -e go -X gofmt -w → fd -e go -x go vet {}fd --changed-within 2h -t f | head -50实战要点
1. 默认比 find 干净
自动跳过隐藏文件与 gitignore 内容,多数日常查找直接 fd 更合适
2. -e 比正则省事
按扩展名筛选可读性最好,复杂后缀再用 -g glob
3. 先 echo 再执行
用 -x/-X 做破坏性操作前,先把命令换成 echo 验证结果集
4. 占位符要分清
{} 全路径、{/} 文件名、{.} 去扩展名、{//} 目录,批量改名全靠它
5. -x 与 -X 语义不同
一个是逐个进程执行,一个是批量传参,性能与命令行长度上限都不同
6. 搜不到先怀疑忽略规则
用 -H 或 -u 验证,再用 .fdignore 精准控制搜索范围
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于fd命令速查
在线 fd 命令速查手册,按安装与版本、基础搜索、类型与元数据过滤、忽略规则与隐藏文件、输出格式、exec 批量执行、与 rg/xargs 组合、实战场景、别名与配置、常见报错与排查等 10 类场景整理 130 余条常用命令与参数组合,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 fd --version 与 apt/yum/brew/cargo/snap 安装与 fd --gen-completions、fd pattern 与 -e rs 扩展名 与 -F 固定串 与 -i/-s 大小写 与 -g glob 模式 与 -p/--full-path 全路径匹配 与 -a 绝对路径 与 -d 深度 与 --min-depth 与 -E 排除 与 -c 强制彩色 与 -L 跟随软链 与 --one-file-system、-t f 文件 与 -t d 目录 与 -t l 软链 与 -t x 可执行 与 -t e 空文件 与 -S/--size 按大小 与 --changed-within 与 --changed-before 与 -o/--owner 按属主、-H 隐藏文件 与 -I 不读忽略规则 与 -u/-uu 逐级放开 与 .fdignore/.gitignore/.ignore 优先级 与 --no-ignore-parent 与 --ignore-file、--print0 NUL 输出 与 --max-results 与 --strip-cwd-prefix 与 --path-separator 与 --base-directory 与 --color、-x/--exec 逐个执行 与 -X/--exec-batch 批量传入 与 {} 与 {/} 与 {//} 与 {.} 与 {/.} 占位符 与 -x sh -c 处理管道与重定向,以及 fd -e py | xargs rg -n TODO 组合检索、fd -e go -X gofmt -w 批量格式化、清理构建产物、查找大文件与近期修改文件、批量改名与转换、配合 fzf 与 shell 变量 cd,还有 unrecognized flag、regex parse error、Search path is not a directory、Permission denied、搜索不到结果(隐藏文件与忽略规则)、-x 中 shell 元字符不生效、{} 未转义、Windows 路径分隔符 等报错排查。适用于项目文件定位与批量重命名、构建产物清理、大文件与陈旧文件排查、代码库文件清单生成、与 rg 组合做定向检索、CI 中按文件类型执行检查,以及运维、SRE 与后端工程师面试复习。
核心能力
- 涵盖 fd --version 与 apt/yum/brew/cargo/snap 安装与 fd --gen-completions、fd pattern 与 -e rs 扩展名 与 -F 固定串 与 -i/-s 大小写 与 -g glob 模式 与 -p/--full-path 全路径匹配 与 -a 绝对路径 与 -d 深度 与 --min-depth 与 -E 排除 与 -c 强制彩色 与 -L 跟随软链 与 --one-file-system、-t f 文件 与 -t d 目录 与 -t l 软链 与 -t x 可执行 与 -t e 空文件 与 -S/--size 按大小 与 --changed-within 与 --changed-before 与 -o/--owner 按属主、-H 隐藏文件 与 -I 不读忽略规则 与 -u/-uu 逐级放开 与 .fdignore/.gitignore/.ignore 优先级 与 --no-ignore-parent 与 --ignore-file、--print0 NUL 输出 与 --max-results 与 --strip-cwd-prefix 与 --path-separator 与 --base-directory 与 --color、-x/--exec 逐个执行 与 -X/--exec-batch 批量传入 与 {} 与 {/} 与 {//} 与 {.} 与 {/.} 占位符 与 -x sh -c 处理管道与重定向,以及 fd -e py | xargs rg -n TODO 组合检索、fd -e go -X gofmt -w 批量格式化、清理构建产物、查找大文件与近期修改文件、批量改名与转换、配合 fzf 与 shell 变量 cd,还有 unrecognized flag、regex parse error、Search path is not a directory、Permission denied、搜索不到结果(隐藏文件与忽略规则)、-x 中 shell 元字符不生效、{} 未转义、Windows 路径分隔符 等报错排查
适用场景
适用于项目文件定位与批量重命名、构建产物清理、大文件与陈旧文件排查、代码库文件清单生成、与 rg 组合做定向检索、CI 中按文件类型执行检查,以及运维、SRE 与后端工程师面试复习。fd命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。
常见问题
- fd命令速查是免费的吗?需要注册或安装吗?
- fd命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
- fd命令速查支持哪些功能?
- 涵盖 fd --version 与 apt/yum/brew/cargo/snap 安装与 fd --gen-completions、fd pattern 与 -e rs 扩展名 与 -F 固定串 与 -i/-s 大小写 与 -g glob 模式 与 -p/--full-path 全路径匹配 与 -a 绝对路径 与 -d 深度 与 --min-depth 与 -E 排除 与 -c 强制彩色 与 -L 跟随软链 与 --one-file-system、-t f 文件 与 -t d 目录 与 -t l 软链 与 -t x 可执行 与 -t e 空文件 与 -S/--size 按大小 与 --changed-within 与 --changed-before 与 -o/--owner 按属主、-H 隐藏文件 与 -I 不读忽略规则 与 -u/-uu 逐级放开 与 .fdignore/.gitignore/.ignore 优先级 与 --no-ignore-parent 与 --ignore-file、--print0 NUL 输出 与 --max-results 与 --strip-cwd-prefix 与 --path-separator 与 --base-directory 与 --color、-x/--exec 逐个执行 与 -X/--exec-batch 批量传入 与 {} 与 {/} 与 {//} 与 {.} 与 {/.} 占位符 与 -x sh -c 处理管道与重定向,以及 fd -e py | xargs rg -n TODO 组合检索、fd -e go -X gofmt -w 批量格式化、清理构建产物、查找大文件与近期修改文件、批量改名与转换、配合 fzf 与 shell 变量 cd,还有 unrecognized flag、regex parse error、Search path is not a directory、Permission denied、搜索不到结果(隐藏文件与忽略规则)、-x 中 shell 元字符不生效、{} 未转义、Windows 路径分隔符 等报错排查。
- fd命令速查适合哪些场景使用?
- 适用于项目文件定位与批量重命名、构建产物清理、大文件与陈旧文件排查、代码库文件清单生成、与 rg 组合做定向检索、CI 中按文件类型执行检查,以及运维、SRE 与后端工程师面试复习。