生成命令的语法类似于 GNU Parallel 的语法

• {}：一个占位符令牌，将被搜索结果的路径所替换（documents/images/party.jpg）。
• {.}：类似于{}，但不含文件扩展名（documents/images/party）。
• {/}：一个占位符，将被搜索结果的基准名所替换（party.jpg）。
• {//}：发现路径的父目录（documents/images）。
• {/.}：移除扩展名后的基准名（party）。

如果不包含占位符，fd会自动在末尾添加一个{}。

并行与串行执行

对于-x/--exec，您可以通过使用-j/--threads选项来控制并行作业的数量。使用--threads=1进行串行执行。

排除特定文件或目录

有时我们希望忽略来自特定子目录的搜索结果。例如，我们可能想要搜索所有隐藏的文件和目录（-H），但排除所有来自.git目录的匹配项。我们可以使用-E（或--exclude）选项来做到这一点。它接受一个任意的glob模式作为参数

> fd -H -E .git …

我们也可以使用此功能跳过挂载的目录

> fd -E /mnt/external-drive …

.. 或者跳过某些文件类型

> fd -E '*.bak' …

为了使这些排除模式永久有效，您可以创建一个.fdignore文件。它们的工作方式类似于.gitignore文件，但仅针对fd。例如

> cat ~/.fdignore
/mnt/external-drive
*.bak

[!注意] fd也支持其他程序（如rg或ag）使用的.ignore文件。

如果您希望fd全局忽略这些模式，可以将它们放入fd的全局忽略文件中。这通常位于macOS或Linux中的~/.config/fd/ignore，以及Windows中的%APPDATA%\fd\ignore。

您可能希望将.git/包含在您的fd/ignore文件中，这样当您使用--hidden选项时，.git目录及其内容就不会被包含在输出中。

删除文件

您可以使用 fd 来删除与您搜索模式匹配的所有文件和目录。如果您只想删除文件，可以使用 --exec-batch/-X 选项来调用 rm。例如，要递归删除所有 .DS_Store 文件，请运行

> fd -H '^\.DS_Store$' -tf -X rm

如果您不确定，首先始终以不带 -X rm 的 fd 调用。或者，使用 rm 的“交互式”选项

> fd -H '^\.DS_Store$' -tf -X rm -i

如果您还想删除某一类目录，可以使用相同的技术。您将需要使用 rm 的 --recursive/-r 标志来删除目录。

[!注意] 在某些情况下，使用 fd … -X rm -r 可能会导致竞争条件：如果您有一个路径类似于 …/foo/bar/foo/… 并且想要删除所有名为 foo 的目录，您可能会遇到外部 foo 目录首先被删除的情况，导致 rm 调用中出现（无害的）"'foo/bar/foo': No such file or directory" 错误。

命令行选项

这是 fd -h 的输出。要查看完整的命令行选项，请使用 fd --help，它还包括一个更详细的帮助文本。

Usage: fd [OPTIONS] [pattern] [path]...

Arguments:
  [pattern]  the search pattern (a regular expression, unless '--glob' is used; optional)
  [path]...  the root directories for the filesystem search (optional)

Options:
  -H, --hidden                     Search hidden files and directories
  -I, --no-ignore                  Do not respect .(git|fd)ignore files
  -s, --case-sensitive             Case-sensitive search (default: smart case)
  -i, --ignore-case                Case-insensitive search (default: smart case)
  -g, --glob                       Glob-based search (default: regular expression)
  -a, --absolute-path              Show absolute instead of relative paths
  -l, --list-details               Use a long listing format with file metadata
  -L, --follow                     Follow symbolic links
  -p, --full-path                  Search full abs. path (default: filename only)
  -d, --max-depth <depth>          Set maximum search depth (default: none)
  -E, --exclude <pattern>          Exclude entries that match the given glob pattern
  -t, --type <filetype>            Filter by type: file (f), directory (d/dir), symlink (l),
                                   executable (x), empty (e), socket (s), pipe (p), char-device
                                   (c), block-device (b)
  -e, --extension <ext>            Filter by file extension
  -S, --size <size>                Limit results based on the size of files
      --changed-within <date|dur>  Filter by file modification time (newer than)
      --changed-before <date|dur>  Filter by file modification time (older than)
  -o, --owner <user:group>         Filter by owning user and/or group
      --format <fmt>               Print results according to template
  -x, --exec <cmd>...              Execute a command for each search result
  -X, --exec-batch <cmd>...        Execute a command with all search results at once
  -c, --color <when>               When to use colors [default: auto] [possible values: auto,
                                   always, never]
      --hyperlink[=<when>]         Add hyperlinks to output paths [default: never] [possible
                                   values: auto, always, never]
  -h, --help                       Print help (see more with '--help')
  -V, --version                    Print version

基准测试

让我们在我的主目录中搜索以 [0-9].jpg 结尾的文件。它包含约 75 万个子目录和大约 400 万个文件。为了平均和统计分析，我正在使用 hyperfine。以下基准测试是在“预热”/预填充的磁盘缓存下执行的（“冷”磁盘缓存的测试结果显示相同的趋势）。

让我们从 find 开始

Benchmark 1: find ~ -iregex '.*[0-9]\.jpg$'
  Time (mean ± σ):     19.922 s ±  0.109 s
  Range (min … max):   19.765 s … 20.065 s

find 如果不需要执行正则表达式搜索，则运行得更快

Benchmark 2: find ~ -iname '*[0-9].jpg'
  Time (mean ± σ):     11.226 s ±  0.104 s
  Range (min … max):   11.119 s … 11.466 s

现在让我们尝试相同的 fd。请注意，fd 默认执行正则表达式搜索。需要 -u/--unrestricted 选项来进行公平的比较。否则，fd 不需要遍历隐藏文件夹和忽略的路径（见下文）

Benchmark 3: fd -u '[0-9]\.jpg$' ~
  Time (mean ± σ):     854.8 ms ±  10.0 ms
  Range (min … max):   839.2 ms … 868.9 ms

对于这个特定的例子，fd 大约比 find -iregex 快 23 倍，比 find -iname 快约 13 倍。顺便说一句，这两个工具找到了完全相同的 546 个文件 😄。

注意：这是在 一台特定机器上进行的 一个特定 基准测试。虽然我们已经进行了许多不同的测试（并发现了一致的结果），但结果可能会有所不同！我们鼓励每个人在自己的系统上尝试。请参阅 此存储库 以获取所有必要的脚本。

> fd -u …

> fd '^[A-Z][0-9]+$'

> fd -- '-pattern'
> fd '[-]pattern'

export FZF_DEFAULT_COMMAND='fd --type file'
export FZF_CTRL_T_COMMAND="$FZF_DEFAULT_COMMAND"

export FZF_DEFAULT_COMMAND='fd --type file --follow --hidden --exclude .git'

export FZF_DEFAULT_COMMAND="fd --type file --color=always"
export FZF_DEFAULT_OPTS="--ansi"

fd --type f -e pdf . $HOME | rofi -keep-right -dmenu -i -p FILES -multi-select | xargs -I {} xdg-open {}

❯ fd | tree --fromfile

❯ fd --extension rs | tree --fromfile
.
├── build.rs
└── src
    ├── app.rs
    └── error.rs

❯ alias as-tree='tree --fromfile'

> fd -0 -e rs | xargs -0 wc -l

apt install fd-find

dpkg -i fd_9.0.0_amd64.deb # adapt version number and architecture

apt-get install fd-find

dnf install fd-find

apk add fd

pacman -S fd

emerge -av fd

zypper in fd

xbps-install -S fd

apt-get install fd

eopkg install fd

dnf copr enable tkbcopr/fd
dnf install fd

brew install fd

port install fd

scoop install fd

choco install fd

winget install sharkdp.fd

guix install fd

nix-env -i fd

flox install fd

pkg install fd-find

npm install -g fd-find

cargo install fd-find

git clone https://github.com/sharkdp/fd

# Build
cd fd
cargo build

# Run unit tests and integration tests
cargo test

# Install
cargo install --path .