qf

qf（快速查找）是一个使文件搜索变得快速而强大的CLI工具。

C:\Users\aidan\Documents> qf *.rs --a[github] --i[rustlings,package,node_modules] --ra
Searching for *.rs...
Ignoring ["rustlings", "package", "node_modules"]
File: main.rs
Path: C:\Users\aidan\Documents\GitHub\ips\src\main.rs
File: main.rs
Path: C:\Users\aidan\Documents\GitHub\qf\src\main.rs
Searched 29901 files. Found 2 files.
Completed in 624.45ms

基本用法

# Find all files that match 'index.js'
qf index.js

通配符

qf 允许使用通配符来改进您的搜索。

qf index.js # Find all files that match index.js 

qf *.js # Find all files that end with '.js'

qf index* # Find all files that start with 'index'

qf *index* # Find all files that contain 'index'

标志

• --i[args] 忽略目录。 文档
• --ri 只在当前工作目录（Current Working Directory）中应用忽略标志。 文档
• --a[args] 允许目录。 文档
• --ra 只在当前工作目录（Current Working Directory）中应用允许标志。 文档
• --c[arg] 允许您指定在允许并发之前目录中的最小条目数。 文档
• --dc 允许您禁用并发。 文档

--i[args]

这允许您跳过在提供的子目录中搜索文件。看起来是这样的。

用法

# Ignore folders that match 'node_modules'
qf index.js --i[node_modules]

# For folder names including a space you must wrap them in '' or ""
qf index.js --i['your name']

--ri

此标志影响 --i 标志的作用位置。当提供 --ri 标志时，--i 标志仅应用于当前工作目录。

假设您的文件结构如下

root
├── modules
├── src
├── release
|   └── random.exe
└── target
    ├── debug
    |   └── qf.exe
    └── release
        └── qf.exe

我们可能想查找一个 *.exe 文件，但运行 qf *.exe 将返回当前工作目录下的所有可执行文件。如果您想忽略根目录中的发行目录但不是任何子文件夹，怎么办？

这又是 --r 标志的用途。

qf *.exe --i[release] --ri

这将忽略 release 目录，但仅限于当前工作目录。任何子文件夹仍将被搜索。

--a[args]

这允许您仅搜索与提供的目录匹配的目录。

用法

# Only searches directories that match 'src'
qf index.js --a[src]

如果您只想列出当前工作目录（Current Working Directory）中的文件而无需搜索其他文件，这也很有用。

# The * will be removed when searching so this says match anything 
# that starts with '' which is everything
# Since '--a[*]' will not match anything no sub-folders will be searched
qf * --a[*]

--ra

此标志影响 --a 标志的作用位置。当提供 --ra 标志时，--a 标志仅应用于当前工作目录。

例如，假设你的文件树看起来像这样

root
├── modules
├── src
└── target
    └── release
        └── qf.exe

如果我单独运行qf qf.exe，我会找到我正在寻找的文件。然而，我不得不在每个模块和src中搜索才能做到这一点。

这就是你想添加--a标志来优化搜索的地方，所以试试吧。

# only include target
qf qf.exe --a[target]

> Searching for qf.exe...
> Searched 7 files. Found 0 files.
> Completed in 559.60µs

当然，这不起作用，因为文件夹release阻止我们看到qf.exe文件，因为它与target目录不匹配。

这就是--r标志有用的地方，因为它允许你仅在当前工作目录（cwd）级别应用--a标志规则。

所以让我们再次尝试，但这次带上--r标志。

# only include target
qf qf.exe --a[target] --ra

> Searching for qf.exe...
> Searched 7 files. Found 1 files.
> Completed in 559.60µs

现在--a规则应用于我们的cwd，但不应用于任何子目录。

--c[arg]

--c标志允许你指定目录中必须包含的最小条目（文件/文件夹）数量，以便程序可以并发地搜索它们。正确使用此标志可以节省一些时间和资源。

用法

# Will require 20 files/folders 
# in a directory before using concurrency
qf index.* --c[20]

默认和最小值是2，因为你不能将1或0个条目分割到并发线程中。

至于设置什么，这完全取决于你要搜索的文件数量。你可能需要进行自己的测试才能真正找出答案。

--dc

--dc标志允许你完全禁用并发。当搜索较小的目录时，这可能很有用，因为并发可能没有好处，或者如果你有时间但想节省资源。

用法

qf index.* --dc

我们显然建议你保持此选项开启，因为当你使用并发搜索较大的目录时，通常可以快两倍。