GeekIt

fd命令速查

安装与基础搜索、类型与元数据过滤、忽略规则、输出格式、exec 批处理、与 rg 组合、实战场景与报错排查等 133 条命令

共 133 条命令 · 10 类场景 · 点击右侧图标可复制

命令 / 片段说明复制
fd --version查看版本,新版参数与老版略有差异
fd -h常用参数摘要
fd --help完整帮助,参数分组清晰
apt install fd-findDebian/Ubuntu 包名是 fd-find,命令为 fdfind
ln -s $(which fdfind) ~/.local/bin/fd给 Debian 系建软链,统一命令名
yum install fd-findRHEL/CentOS 安装
brew install fdmacOS 安装
cargo install fd-findRust 工具链安装,版本最新
snap install fdsnap 安装
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 foundDebian 系命令名是 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 -rf
定向内容检索fd -e yaml -X rg -n "image:" → 只搜 yaml 里的镜像定义
查找大文件fd -t f -S +200M -x du -h {} | sort -h -r | head -20
批量改名fd -e jpeg -x mv {} {.}.jpg
批量格式化fd -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 精准控制搜索范围

共 133 条 fd 命令 · 示例中的路径与模式请替换为实际环境

关于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 与后端工程师面试复习。