fd
优先使用 fd 而非 find 进行文件系统搜索。
fd 在大型目录树上速度更快,
具有更合理的默认行为
(尊重 .gitignore、智能大小写、默认使用正则表达式),
以及更符合人体工程学的 CLI。
权威文档:
https://github.com/sharkdp/fd
(README + fd --help)。
在依赖任何非平凡用法之前,请对照手册验证。
为什么选择 fd
- 并行目录遍历——在大型仓库上明显快于
find。 - 开箱即用的合理默认值:
跳过隐藏条目,
在 git 仓库内时尊重
.gitignore/.ignore/.fdignore, 智能大小写 (除非模式包含大写字母,否则不区分大小写), 默认模式为正则表达式。 - 默认只匹配文件名而非完整路径——
fd foo完成find . -iname '*foo*'的功能, 无需通配符和引号的繁琐操作。 - 并行
-x执行、 null 分隔输出(-0), 以及一组无需-print/-prune技巧即可组合使用的选项。
规则
fd PATTERN [PATH]
第一个位置参数是模式;
第二个是搜索根目录
(默认为当前目录)。
注意:第一个参数如果包含 /,它不是路径——
请使用 fd . PATH 或 fd --full-path PATTERN。
直接替换
| 不要使用 | 请使用 |
|---|---|
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 / |
如需精确匹配 find -size,
请使用二进制后缀
(ki、mi、gi)——
-S +100m 表示 100 * 10^6 字节,
-S +100mi 表示 100 * 2^20 字节。
对于也需要搜索隐藏和 .gitignore 目录的 find / 搜索,
请添加 -u(--no-ignore --hidden 的别名)。
惯用模式
按扩展名匹配(一个或多个):
fd -e md
fd -e h -e cpp
Glob 模式用于 shell 风格的模式
(-g 使得 ** 和 * 表示通常的含义):
fd -g '**/*.test.ts'
fd -g 'libc.so' /usr
匹配完整路径而非仅文件名:
fd --full-path 'src/.*\.proto$'
包含隐藏条目
(.git、.vscode 等)
但保留 .gitignore 规则:
fd -H pre-commit
忽略 .gitignore 规则但保持隐藏条目隐藏:
fd -I node_modules
全面搜索——同时包含隐藏和忽略条目:
fd -u PATTERN
排除路径 (glob 语法,覆盖所有忽略规则,可重复使用):
fd -E .git -E '*.bak' PATTERN
限制深度:
fd -d 2 -t d
组合多个必要模式 (所有模式必须匹配文件名,默认为正则表达式):
fd 'foo' --and 'bar' --and 'baz'
对每个结果执行命令
(并行执行,{} 替换,无需 \; 终止符):
fd -e jpg -x convert {} {.}.png
一次性执行命令,将所有结果作为参数
(批量工具如 wc、clang-format、rg):
fd -e rs -X wc -l
管道输出(null 分隔)到其他工具:
fd -e go -0 | xargs -0 wc -l
常见陷阱
- 第一个位置参数是模式,而非路径。
fd /etc/passwd会将/etc/passwd解释为包含/的正则表达式, 并报错, 建议使用fd . /etc/passwd或--full-path。 - 默认搜索排除隐藏和
.gitignore条目。 当在node_modules或.git内查找内容时, 请添加-H -I(或-u), 否则结果列表会因错误原因而为空。 --exec默认并行执行。 输出顺序不确定。 当需要串行执行时,请传递-j 1(或--threads 1)。- 默认模式为正则表达式。
单独的
.匹配任意字符; 如需匹配字面量.foo,请使用锚点('\.foo$') 或传递-F/--fixed-strings。 - 大小后缀默认使用十进制 SI 单位。
-S +100m表示100 MB(每m为10^6字节); 如需精确匹配find -size语义, 请使用mi/ki/gi表示二进制单位。
回退到 find
fd 并非始终可用——
最小的 CI 镜像、
锁定的服务器、
没有额外软件包的容器基础镜像。
使用 command -v 探测,并回退到 find:
if command -v fd >/dev/null; then
fd -e log -t f -X rm
else
find . -type f -name '*.log' -exec rm {} +
fi
对于受控本地环境中的一次性脚本,
可以直接使用 fd。
仅当已知目标主机没有 fd 时
(例如,一个不包含 fd 的最小 Alpine 容器),
才无条件切换到 find。
不要仅仅为了满足此技能而自动安装 fd——\n回退方案是在缺失时的正确响应。
安装 fd
- macOS:
brew install fd - Debian/Ubuntu:
apt install fd-find—— 二进制文件名为fdfind以避免名称冲突 (alias fd=fdfind是标准解决方法)。 - Fedora:
dnf install fd-find - Arch:
pacman -S fd - Alpine:
apk add fd - 预编译二进制文件和其他平台: https://github.com/sharkdp/fd/releases
当 mise 管理主机的工具时,
注册中心短名称 fd 解析为 aqua:sharkdp/fd——
使用 mise use -g fd@<version> 安装
(固定版本,按照项目的 mise 技能要求)。
不要使用 ubi: 后端——
mise 技能禁用了它。
适用范围
适用于任何需要搜索文件系统的 shell 片段:
Bash工具调用。SKILL.md/README.md/ 文档中的代码片段。scripts/下的脚本。- Makefile 配方。
- CI 配置。
- 安装说明。
如果在编辑文件时遇到 find 调用,
请将其替换为等效的 fd 形式
(如果代码段必须在可能没有 fd 的主机上运行,
则加上 find 回退方案),
作为同一编辑的一部分。