fd

「 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是一种简单ㄡ快速和用户友好的fd替代方案.

虽然它不寻求复刻find所有强大的功能,但它提供了明智的 (自定的) 80%的用例.

特征

• 方便语法:

  fd PATTERN

  而不是

  find -iname '*PATTERN*'

  .
• 彩色终端输出 (类似于ls)
• 它是快速的 (见基准下面) .
• 聪明案例: 默认情况下,搜索不区分大小写. 如果模式包含大写字符*, 则切换为区分大小写字符. .
• 默认情况下,忽略隐藏的目录和文件.
• 忽略匹配你

  .gitignore

  文件中的模式,默认情况.
• 正则表达式.
• Unicode感知.
• 命令输入量50%优于*

  find

  : -)
• 用类似于GNU穿行的语法，执行并行命令.

演示

基准

让我们搜索我的主文件夹的以

[0-9].jpg

让我们从

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

最后,让我们运行

fd

--hidden

--no-ignore

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

彩色输出

fd

ls

LS_COLORS

dircolors

LS_COLORS

并行命令执行

如果

-x

--exec

• {}

  : 将被替换为搜索结果路径的占位符令牌 (

  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

安装

Ubuntu

以及其他基于Debian的Linux发行版.

下载最新

.deb

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

Fedora

从 FEDORA 28 开始,您可以从官方包装来源安装

fd

dnf install fd-find

对于旧版本,您可以使用Fedora copr安装

fd

dnf copr enable keefle/fd
dnf install fd

Arch Linux

你可以从官方回购安装fd 软件包:

pacman -S fd

Gentoo Linux

你可以从官方回购使用fd 软件包:

emerge -av fd

openSUSE Linux

你可以从官方回购安装fd 软件包:

zypper in fd

Void Linux

你可以安装

fd

xbps-install -S fd

macOS

你可以安装

fd

brew install fd

或与Mac port:

sudo port install fd

Windows

您可以从中 releases页面，下载预构建的二进制文件.

或者,您可以安装

fd

scoop install fd

或通过Chocolatey:

choco install fd

NixOS / via Nix

你可以使用NixOS 包管理安装

fd

nix-env -i fd

FreeBSD

你可以安装

sysutils/fd

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] [] [...]

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         设置最大搜索深度（默认值：无）
    -t, --type ...       按类型过滤：文件（f），目录（d），符号链接（l），
                                   可执行（x），空（e）
    -e, --extension ...       按文件扩展名过滤
    -x, --exec                为每个搜索结果执行命令
    -E, --exclude ...     排除与给定glob模式匹配的条目
        --ignore-file ...    以.gitignore格式添加自定义忽略文件
    -c, --color              何时使用颜色：never，auto, always
    -j, --threads             设置用于搜索和执行的线程数
    -S, --size ...           根据文件大小限制结果。
ARGS:
        the search pattern, a regular expression (optional)
    ...    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

fd可以不带参数调用. 这是非常有用的,以便快速地查看当前目录中的所有条目,递归地 (类似于

ls -R

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

搜索特定的文件扩展名

通常,我们对特定类型的所有文件感兴趣. 这可以用

-e

--extension

> 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

使用fd 带

xargs

或

parallel

如果我们想在所有搜索结果上运行命令,我们可以将输出管

xargs

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

这里,

-0

xargs

-0

与其他程序的集成

使用fd与

fzf

你可以使用fd生成fzf命令行模糊查找器的输入:

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

然后,您可以键入

vim 

或者,您可能喜欢遵循符号链接并包含隐藏文件 (但不包括

.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文件的提示部分.

使用fd与

emacs

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