如何安装 fd 快速找文件：.gitignore 忽略规则、常用 flags 与 find 对照

安装 fd，读懂 ignore 规则，常用 flags 速查，并知道何时仍用 find。

在 monorepo 里按文件名找配置或源码，find 能办到但语法绕、还容易扫进 node_modules。fd（sharkdp 的 Rust 工具）把「按路径快速列文件」做成默认递归、默认尊重忽略规则的一行命令。本教程专注 macOS/Linux 安装 fd、.gitignore 与 .fdignore 等忽略规则、常用 flags，以及与 find 的对照，面向 hereink 读者与 ripgrep 并用的终端工作流。

检索词是如何安装 fd 快速找文件并理解 gitignore 与 find 区别。读完应能安装 fd、在项目根跑第一条搜索、读懂默认跳过哪些目录，并知道复杂条件何时仍用 find。

fd 解决什么问题

上游：github.com/sharkdp/fd。安装后运行 fd --version 确认。

在 macOS 与 Linux 安装

1. 1
   macOS（Homebrew）

   brew install fd。验证：which fd 与 fd --version。

2. 2
   Debian / Ubuntu

   sudo apt update && sudo apt install fd-find。二进制常为 fdfind；在 shell 配置里 alias fd=fdfind，或按发行版说明启用 fd 命令名。

3. 3
   Fedora / Arch

   Fedora：sudo dnf install fd。Arch：sudo pacman -S fd。版本偏旧时可从 GitHub Releases 下载对应架构二进制并加入 PATH。

4. 4
   可选：Rust 工具链

   cargo install fd-find。编译较慢，适合包管理器未提供新版本的环境。

忽略规则：fd 默认跳过什么

在 Git 仓库内，fd 默认启用 ignore 规则，行为与 ripgrep 类似：

• .gitignore：项目与各子目录中的规则；未跟踪但匹配的路径通常也不列出。
• .ignore 与全局 ignore 文件（见 man fd 与官方 README 的 ignore 章节）。
• .fdignore：仅 fd 读取，适合「不想改团队 .gitignore，但本地 fd 要再排除一批路径」。
• .git 目录本身默认不参与结果（找文件时不会把 .git/objects 当普通文件列出来）。

# 列出会匹配的路径，但仍应用 ignore（正常开发默认）
fd Cargo.toml

# 包含被 .gitignore 忽略的路径（输出会暴增，慎用）
fd --no-ignore vendor

# 不读任何 ignore 文件（含 .gitignore、.fdignore）
fd -I secret

# 仍 respect ignore，但额外匹配隐藏文件/目录（名称以 . 开头）
fd -H .env

# 只搜当前目录一层（不递归）
fd --max-depth 1 Makefile

常用 flags 速查

# 按扩展名（不要写点）
fd -e rs
fd -e ts -e tsx

# 只要普通文件 / 目录 / 符号链接
fd -t f README
fd -t d src
fd -t l

# 忽略大小写
fd -i dockerfile

#  glob 模式（整段路径匹配）
fd -g '*.min.js'

# 排除路径片段（可重复 -E）
fd -E node_modules -E '*.pyc' test

# 对每条结果执行命令（比裸 xargs 更安全处理空格）
fd -e md -x wc -l {}

# 指定起始目录
fd '\.toml$' ./crates

需要跟随符号链接遍历加 -L 或 --follow；只列出目录加 --type directory（同 -t d）。完整列表：fd --help。

fd 与 find 对照

组合示例：fd -e py | xargs rg 'def main' 先圈 Python 再搜内容；含空格路径优先 fd … -x rg pattern {}。

适合

每天在仓库里按名称/扩展名列文件、写脚本前快速圈定范围、与 rg/bat 同一栈的人。

不适合

纯按 mtime 清理磁盘、复杂布尔条件或必须在最小容器镜像里只依赖 POSIX 的运维脚本——保留 find。