用法

USAGE:
    ff [FLAGS] [OPTIONS] <PATTERN> [ROOT_PATH]

FLAGS:
    -s, --case-sensitive       Search case sensitively. By default, files are
                               searched case insensitively.
    -D, --exclude-dir-paths    Exclude paths from the search result which are
                               directories and not files.
    -h, --help                 Prints help information
    -G, --ignore-gitignore     Ignore searching files and directories specified
                               in .gitignore. By default, the files and
                               directories specified in .gitignore are included
                               in the search results.
    -H, --ignore-hidden        Ignore searching hidden files and directories. By
                               default, hidden files and directories are
                               included in the search results.
    -V, --version              Prints version information

OPTIONS:
    -x, --exclude <exclude>    Exclude files and directories matching this
                               regular expression from the search results.
    -L, --level <level>        Recursively search only given level directories
                               deep. By default no depth restriction is imposed.
                               A value of 0 would always yield zero results. A
                               value of 1 searches for the direct children in
                               the given path.
    -j, --threads <threads>    The approximate number of threads to use. A value
                               of 0 (which is the default) results in thread
                               count set to available CPU cores.

ARGS:
    <PATTERN>      Find files whose name (path) matches this substring or
                   the regular expression.
    <ROOT_PATH>    Path to the directory to search files inside.[default:
                   `$PWD`]

示例

使用ff搜索文件有无数种可能性。以下示例仅展示了冰山一角。

• 列出当前工作目录中匹配article字符串的文件路径。

  ff article
  

• 列出扩展名为.png或.PNG的文件。

  ff png$
  

• 列出具有严格 .PNG 扩展名的文件。

  ff -s PNG$
  

• 搜索各种图像文件。

  ff "\.(png|jpg|jpeg|gif|svg)$"
  

• 列出路径匹配 controllers 字符串的文件。

  ff controllers
  

• 在 ./spec 目录中搜索 .js 文件。

  ff \.js ./spec
  

• 搜索预期位于隐藏 .git 目录内，且名称包含 commit 或类似内容的文件。

  $ ff git.*commit
  
  ./.git/COMMIT_EDITMSG
  # omitted other results
  

• 在搜索结果中不显示隐藏文件和目录。

  ff something -H
  

• 在搜索结果中不显示那些在 .gitignore 中列出的文件和目录。

  ff src/.*js$ -G
  

  在上述命令中如果没有 -G (--ignore-gitignore) 标志，它默认也会包括 node_modules 等目录的结果。

• 不显示仅是目录而非实际文件的路径。

  $ ff -D user
  
  ./app/models/user.rb
  ./app/models/user/address.rb
  ./specs/models/user_spec.rb
  ./specs/models/user/address_spec.rb
  

  在上述命令中如果没有 -D (--exclude-dir-paths) 标志，它也会在结果中包含匹配的目录路径，如下所示。

  $ ff user
  
  ./app/models/user.rb
  ./app/models/user
  ./app/models/user/address.rb
  ./specs/models/user_spec.rb
  ./specs/models/user
  ./specs/models/user/address_spec.rb
  

• 排除（省略）与提供的可选排除正则表达式模式匹配的文件和目录。

  ff rb$ app/controllers -x /(audit|admin|sso|api)/
  

  上述命令将显示相对 app/controllers 目录内所有以 rb 结尾的文件的路径，排除匹配 /(audit|admin|sso|api)/ 模式的路径。

• 限制在给定路径中搜索不超过3层深度。

  ff -L 3 .js$