「 fd是ぜ一いち种简单ㄡ快速かいそく和わ用よう户友好ゆうこう的てきfind替がえ代だい方案ほうあん.」

中ちゅう文ぶん | english

翻こぼし译的原文げんぶん	与あずか日にち期き	最新さいしん更新こうしん	更さら多おお
commit	⏰ 2018 8.20		中ちゅう文ぶん翻こぼし译

欢迎 👏 勘かん误/校こう对/更新こうしん贡献 😊 具体ぐたい贡献请看

If help, buy me coffee —— 营养跟不上うえ了りょう，给我来らい瓶びん营养快かい线吧! 💰

• fd
  • 特とく征せい
  • 演えんじ示しめせ
  • 基もと准じゅん
  • 彩色さいしき输出
  • 并行命令めいれい执行
  • 安あん装そう
    • Ubuntu
    • Fedora
    • Arch Linux
    • Gentoo Linux
    • openSUSE Linux
    • Void Linux
    • macOS
    • Windows
    • NixOS / via Nix
    • FreeBSD
    • 源みなもと码文件けん
    • 二に进制文ぶん件けん
  • 开发
  • 命令めいれい行ぎょう选项
  • 教程きょうてい
    • 简单搜索そうさく
    • 正せい则表达式搜索そうさく
    • 指定してい根ね目め录
    • 仅运行ぎょうfd
    • 搜索そうさく特定とくてい的てき文ぶん件けん扩展名めい
    • 隐藏和わ忽ゆるがせ略りゃく的てき文ぶん件けん
    • 排除はいじょ特定とくてい文ぶん件けん或ある目め录
    • 使用しようfd 带xargs或あるparallel
    • 与あずか其他程ほど序じょ的てき集成しゅうせい
      • 使用しようfd与あずかfzf
      • 使用しようfd与あずかemacs

fd是ぜ一いち种简单ㄡ快速かいそく和わ用よう户友好ゆうこう的てきfd替がえ代だい方案ほうあん.

虽然它不寻求复刻find所有しょゆう强大きょうだい的てき功こう能のう,但ただし它提供ていきょう了りょう明智めいち的てき (自じ定じょう的てき) 80%的てき用例ようれい.

• 方便ほうべん语法: fd PATTERN而不是ぜfind -iname '*PATTERN*'.
• 彩色さいしき终端输出 (类似于ls)
• 它是快速かいそく的てき (见基もと准じゅん下面かめん) .
• 聪明案あん例れい: 默だま认情况下,搜索そうさく不ふ区分くぶん大小だいしょう写うつし. 如果模も式しき包含ほうがん大だい写字しゃじ符ふ*, 则切换为区分くぶん大小だいしょう写字しゃじ符ふ. .
• 默だま认情况下,忽ゆるがせ略りゃく隐藏的てき目め录和文わぶん件けん.
• 忽ゆるがせ略りゃく匹ひき配はい你.gitignore文ぶん件けん中ちゅう的てき模も式しき,默だま认情况.
• 正せい则表达式.
• Unicode感知かんち.
• 命令めいれい输入量りょう*50%*优于*find: -)
• 用よう类似于GNU穿ほじ行くだり的てき语法，执行并行命令めいれい.

让我们搜索そうさく我が的てき主文しゅぶん件けん夹的以[0-9].jpg为结束たば的てき文ぶん件けん. 它包含ほうがん190个子目め录和大だい约一百ひゃく万まん个文件けん. 我わが使用しようhyperfine进行平均へいきん和わ统计分析ぶんせき. 下面かめん的てき基もと准じゅん是ぜ用よう"warm"/预填充たかし的てき磁盘缓存执行的てき (对于"冷ひや"磁盘缓存的てき结果显示出で相しょう同どう的てき趋势) .

让我们从find:

Benchmark #1: find ~ -iregex '.*[0-9]\.jpg$'

  Time (mean ± σしぐま):      7.236 s ±  0.090 s

  Range (min … max):    7.133 s …  7.385 s

find如果不ふ需要じゅよう执行正せい则表达式搜索そうさく,则会更さら快かい得とく多た:

Benchmark #2: find ~ -iname '*[0-9].jpg'

  Time (mean ± σしぐま):      3.914 s ±  0.027 s

  Range (min … max):    3.876 s …  3.964 s

现在让我们尝试同样的fd. 注意ちゅういfd 总是执行正せい则表达式搜索そうさく. 选项--hidden和わ--no-ignore需要じゅよう自じ行くだり决策, 下面かめん的てきfd需要じゅよう遍へん历隐藏ぞう文ぶん件けん夹和忽ゆるがせ略りゃく的てき路ろ径みち (见下文ぶん) :

Benchmark #3: fd -HI '.*[0-9]\.jpg$' ~

  Time (mean ± σしぐま):     811.6 ms ±  26.9 ms

  Range (min … max):   786.0 ms … 870.7 ms

对于这个特殊とくしゅ的てき例れい子こ,fd大だい约比find -iregex快かい九きゅう倍ばい,和大かずひろ约比find -iname快かい五ご倍ばい. 顺便说一下か,两个工具こうぐ都と找到了りょう完全かんぜん相しょう同どう的てき20880个文件けん: 😄 .

最さい后きさき,让我们运行ぎょうfd没ぼつ有ゆう--hidden和わ--no-ignore选项 (当然とうぜん,这会导致不同ふどう的てき搜索そうさく结果) . 如果fd不ふ必遍历隐藏ぞう的てき和わGit忽ゆるがせ略りゃく的てき文ぶん件けん夹,它的数量すうりょう级快了りょう一いち个数量すうりょう级:

Benchmark #4: fd '[0-9]\.jpg$' ~

  Time (mean ± σしぐま):     123.7 ms ±   6.0 ms

  Range (min … max):   118.8 ms … 140.0 ms

注ちゅう释这是在ざい一いち个特定とくてい的てき机つくえ器き上じょう的てき一いち个特定とくてい的てき基もと准じゅん. 虽然我わが已やめ经做了りょう很多不同ふどう的てき测试 (并且发现了りょう一致いっち的てき结果) ,但ただし是ぜ事情じじょう可能かのう对你来らい说不同ふどう. 我わが鼓こ励每个人自己じこ尝试测试. 在ざい这个仓库是ぜ所有しょゆう用よう于对比ひ的てき脚本きゃくほん.

关于fd的てき速度そくど,主要しゅよう的てき耗时在ざいregex和わignore,还有ripgrep箱はこ子こ (检查一いち下か!) .

fd可か以通过扩展てん来らい帮输出で着色ちゃくしょく,就像ls. 为了使し这工作こうさく,环境变量LS_COLORS必须设置. 通常つうじょう,此变量的りょうてき值由dircolors命令めいれい控ひかえ制せい,它提供ていきょう了りょう一いち种方便びん的てき配置はいち格式かくしき,来き定てい义不同文どうぶん件けん格式かくしき的てき颜色. 在ざい大だい多数たすう分配ぶんぱい情じょう况,LS_COLORS应该已やめ经设置おけ好こう了りょう. 如果您正在ざい寻找替がえ代だい的てき，且更完かん整せい的てき (以及更さら丰富多彩たさい的てき) 变体,请参见在ざい这里或ある在ざい这里.

如果-x/--exec选项与命令めいれい模も板ばん一いち起おこり指定してい,将はた创建一いち个作业池,用よう于并行ぎょう执行命令めいれい，每まい个发现的路ろ径みち则作为输入いれ. 生成せいせい命令めいれい的てき语法类似于GNU穿ほじ行くだり的てき语法:

• {}: 将はた被ひ替がえ换为搜索そうさく结果路ろ径みち的てき占うらない位い符ふ令れい牌ぱい (documents/images/party.jpg)
• {.}: 像ぞう{},但ただし没ぼっ有ゆう文ぶん件けん扩展名めい (documents/images/party)
• {/}:占うらない位い符ふ,将はた被ひ搜索そうさく结果的てき基もと名めい替がえ换 (占うらない位い符ふ) . party.jpg)
• {//}:使用しよう已やめ发现路ろ径みち的てき父ちち节点 (documents/images)
• {/.}:使用しようBaseNeNe,将はた扩展名めい移うつり除じょ (party)

# 转换 所有しょゆう jpg 到いた  png :
fd -e jpg -x convert {} {.}.png

# Unpack all zip files (if no placeholder is given, the path is appended):
fd -e zip -x unzip

# Convert all flac files into opus files:
fd -e flac -x ffmpeg -i {} -c:a libopus {.}.opus

# Count the number of lines in Rust files (the command template can be terminated with ';'):
fd -x wc -l \; -e rs

以及其他基もと于Debian的てきLinux发行版ばん.

下しも载最新さいしん.deb包装ほうそう从releases页面并通过以下か方式ほうしき安あん装そう:

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

从 FEDORA 28 开始,您可以从官かん方かた包装ほうそう来らい源みなもと安あん装そうfd:

dnf install fd-find

对于旧きゅう版本はんぽん,您可以使用しようFedora copr安あん装そうfd:

dnf copr enable keefle/fd
dnf install fd

你可以从官かん方かた回かい购安装そうfd 软件包つつみ:

pacman -S fd

你可以从官かん方かた回かい购使用しようfd 软件包つつみ:

emerge -av fd

你可以从官かん方かた回かい购安装そうfd 软件包つつみ:

zypper in fd

你可以安装そうfd通つう过xbps安あん装そう:

xbps-install -S fd

你可以安装そうfd具有ぐゆうbrew:

brew install fd

或ある与あずかMac port:

sudo port install fd

您可以从中ちゅう releases页面，下しも载预构建的てき二に进制文ぶん件けん.

或ある者もの,您可以安装そうfd通つう过Scoop:

scoop install fd

或ある通つう过Chocolatey:

choco install fd

你可以使用しようNixOS 包つつみ管理かんり安あん装そうfd:

nix-env -i fd

你可以安装そうsysutils/fd通つう过patmaster:

portmaster sysutils/fd

你可以通过rust的てき包つつみ管理かんりcargo安あん装そうfd:

cargo install fd-find

注意ちゅういrust版本はんぽん要よう1.20.0或ある以上いじょう.

这个releases页面包括ほうかつLinux,MaOS和わWindows的てき预编译二に进制文ぶん件けん.

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

# Build
cd fd
cargo build

# Run unit tests and integration tests
cargo test

# Install
cargo install

USAGE:
    fd [FLAGS/OPTIONS] [<pattern>] [<path>...]

FLAGS:
    -H, --hidden            搜索そうさく隐藏的てき文ぶん件けん和わ目め录
    -I, --no-ignore         不要ふよう忽ゆるがせ略りゃく .(git | fd)ignore 文ぶん件けん匹ひき配はい
        --no-ignore-vcs     不要ふよう忽ゆるがせ略りゃく.gitignore文ぶん件けん的てき匹ひき配はい
    -s, --case-sensitive    区分くぶん大小だいしょう写うつし的てき搜索そうさく（默だま认值：智能ちのう案あん例れい）
    -i, --ignore-case       不ふ区分くぶん大小だいしょう写うつし的てき搜索そうさく（默だま认值：智能ちのう案あん例れい）
    -F, --fixed-strings     将しょう模も式しき视为文字もじ字じ符ふ串くし
    -a, --absolute-path     显示绝对路ろ径みち而不是ぜ相しょう对路径みち
    -L, --follow            遵循符号ふごう链接
    -p, --full-path         搜索そうさく完かん整せい路ろ径みち（默だま认值：仅限 file-/dirname）
    -0, --print0            用ようnull字じ符ふ分ぶん隔へだた结果
    -h, --help              打だ印しるし帮助信しん息いき
    -V, --version           打だ印しるし版本はんぽん信しん息いき

OPTIONS:
    -d, --max-depth <depth>        设置最大さいだい搜索そうさく深度しんど（默だま认值：无）
    -t, --type <filetype>...       按类型がた过滤：文ぶん件けん（f），目め录（d），符号ふごう链接（l），
                                   可か执行（x），空そら（e）
    -e, --extension <ext>...       按文件けん扩展名めい过滤
    -x, --exec <cmd>               为每个搜索そうさく结果执行命令めいれい
    -E, --exclude <pattern>...     排除はいじょ与あずか给定glob模も式しき匹ひき配はい的てき条目じょうもく
        --ignore-file <path>...    以.gitignore格式かくしき添加てんか自じ定てい义忽略りゃく文ぶん件けん
    -c, --color <when>             何なに时使用しよう颜色：never，*auto*, always
    -j, --threads <num>            设置用よう于搜索そうさく和わ执行的てき线程数すう
    -S, --size <size>...           根ね据すえ文ぶん件けん大小だいしょう限げん制せい结果。

ARGS:
    <pattern>    the search pattern, a regular expression (optional)
    <path>...    the root directory for the filesystem search (optional)

首くび先さき,为了获得所有しょゆう可用かよう的てき命令めいれい行ぎょう选项的てき概がい述じゅつ,您可以运行ぎょうfd -h的てき简明帮助消息しょうそく (见上文ぶん) 或あるfd --help更さら详细的てき版本はんぽん.

fd设计用よう于查找文件けん系けい统中的てき条目じょうもく. 你可以执行ぎょう的てき最さい基本きほん的てき搜索そうさく就是运行一いち个参数すう:搜索そうさく模も式しき的てきfd. 例れい如,假かり设您想そう查找您的旧きゅう脚本きゃくほん (包括ほうかつnetflix) :

> fd netfl
Software/python/imdb-ratings/netflix-details.py

如果只ただ调用一个这样的参数,fd递归检索当とう前目まえめ录中, 包含ほうがん模も式しきnetfl的てき任にん何なん条じょう目め.

搜索そうさく模も式しき被ひ视为正せい则表达式. 这里,我わが们搜索そうさく开始x并以rc结束的てき条目じょうもく. :

> cd /etc
> fd '^x.*rc$'
X11/xinit/xinitrc
X11/xinit/xserverrc

如果我わが们想搜索そうさく一个特定的目录,它可以作为第二に个参数すうfd:

> fd passwd /etc
/etc/default/passwd
/etc/pam.d/passwd
/etc/passwd

fd可か以不带参数すう调用. 这是非常ひじょう有用ゆうよう的てき,以便快速かいそく地ち查看当とう前目まえめ录中的てき所有しょゆう条目じょうもく,递归地ち (类似于ls -R) :

> cd fd/tests
> fd
testenv
testenv/mod.rs
tests.rs

通常つうじょう,我わが们对特定とくてい类型的てき所有しょゆう文ぶん件けん感かん兴趣. 这可以用-e (或ある) --extension选择权. 在ざい这里,我わが们搜索そうさくFD仓库中ちゅう的てき所有しょゆうmd文ぶん件けん:

> cd fd
> fd -e md
CONTRIBUTING.md
README.md

这个-e选项可か以与搜索そうさく模も式しき结合使用しよう:

> fd -e rs mod
src/fshelper/mod.rs
src/lscolors/mod.rs
tests/testenv/mod.rs

默だま认情况下,fd不ふ搜索そうさく隐藏目め录,不在ふざい搜索そうさく结果中ちゅう显示隐藏文ぶん件けん. 若わか要よう禁きん用よう此行为,我わが们可以使用しよう-H (或ある) --hidden选项:

> fd pre-commit
> fd -H pre-commit
.git/hooks/pre-commit.sample

如果我わが们在一いち个Git存そん储库 (或ある者もの包括ほうかつGit存そん储库) 中ちゅう工作こうさく,fd不ふ搜索そうさく.gitignore文ぶん件けん中ちゅう匹ひき配はい模も式しき (并且不ふ显示文ぶん件けん) . 若わか要よう禁きん用よう此行为,我わが们可以使用しよう-I (或ある) --no-ignore选项:

> fd num_cpu
> fd -I num_cpu
target/debug/deps/libnum_cpus-f5ce7ef99006aa05.rlib

真正しんしょう搜索そうさく全部ぜんぶ的てき文ぶん件けん和わ目め录,简单地ち组合隐藏和わ忽ゆるがせ略りゃく的てき特性とくせい来らい显示一切いっさい (-HI)

有ゆう时我们希望きぼう忽ゆるがせ略りゃく来らい自じ特定とくてい子こ目め录的搜索そうさく结果. 例れい如,我わが们可能かのう要よう搜索そうさく所有しょゆう隐藏的てき文ぶん件けん和わ目め录 (-H,但ただし仍会排除はいじょ所有しょゆう.git目め录. 我わが们可以使用しよう-E (或ある) --exclude选择此选项. 它以任意にんい的てき模も式しき作さく为一个参数すう:

> fd -H -E .git …

我わが们也可か以用这个来らい跳とべ过安装そう的てき目め录:

> fd -E /mnt/external-drive …

或ある跳とべ过某些文件けん类型:

> fd -E '*.bak' …

为了让这些模式しき永久えいきゅう不ふ变,你可以创建けん一いち个.fdignore文ぶん件けん. 他た们工作こうさく得とく很像.gitignore文ぶん件けん. 例れい如:

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

如果我わが们想在ざい所有しょゆう搜索そうさく结果上じょう运行命令めいれい,我わが们可以将输出管かんxargs:

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

这里,-0选项告つげ诉fd用よう空そら字じ符ふ (而不是ぜ换行符ふ) 分ぶん隔へだた搜索そうさく结果. 以同样的方式ほうしき,xargs的てき-0选项同どう样告诉它以这种方式しき读取输入.

你可以使用しようfd生成せいせいfzf命令めいれい行ぎょう模糊もこ查找器き的てき输入:

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

然しか后きさき,您可以键入いれvim <Ctrl-T>在ざい你的终端打だ开FZF，也即是ぜfd的てき搜索そうさく结果.

或ある者もの,您可能かのう喜き欢遵循符号ごう链接并包含ほうがん隐藏文ぶん件けん (但ただし不ふ包括ほうかつ.git文ぶん件けん夹) :

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

你甚至いたり可か以通过设置おけfzf内ない的てきfd的てき颜色输出:

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

有ゆう关详细信息いき,请参见 fzf reamde文ぶん件けん的てき提示ていじ部分ぶぶん.

Emacs封ふう装そう了りょうfind-file-in-project包つつめ, 这可以使用しようfd查找文ぶん件けん.

安あん装そうfind-file-in-project后きさき，添加てんか行ぎょう(setq ffip-use-rust-fd t)在ざい你的~/.emacs或ある~/.emacs.d/init.el文ぶん件けん中ちゅう.

在ざいEmacs中ちゅう,运行M-x find-file-in-project-by-selected查找匹ひき配はい文ぶん件けん. 或ある者もの,运行M-x find-file-in-project列れつ出で项目中ちゅう所有しょゆう可用かよう的てき文ぶん件けん.