ag

补充说明

> 摘自 项目的 Readme.md

• 它比ack快一个数量级。

• 它忽略了你的 .gitignore 和 .hgignore 中的文件模式。

• 如果你的源码库里有你不想搜索的文件，只要把它们的模式添加到一个.ignore文件里。(*cough* *.min.js*cough*)

• 这个命令的名字比ack短33%，而且所有的键都在主行上!

  语法

  shell
  ag [options] pattern [path ...]
  ag [可选项] 匹配模式 [路径...]
  

  📋✓

  选项

  shell
  输出选项:
       --ackmate            以 AckMate-parseable 的格式显示结果
    -A --after [LINES]      显示匹配行之后的行（默认2行）
    -B --before [LINES]     显示匹配行之前的行（默认2行）
       --[no]break          不同文件中匹配到的内容新建一行显示（默认开启）
    -c --count              只显示每个文件中匹配到的数量 （通常与匹配行数不同）
       --[no]color          在结果中打印颜色代码（默认启用）
       --color-line-number  行号的颜色代码（默认值为：1;33）。
       --color-match        匹配结果的颜色代码（默认值为：30;43）。
       --color-path         路径名称的颜色代码（默认值为：1;32）
       --column             打印结果中的列号
       --[no]filename       打印文件名（除非搜索单个文件，否则启用）。
    -H --[no]heading        在每个文件匹配前输出文件名（默认开启）
    -C --context [LINES]    显示匹配行上下两行（默认2行）
       --[no]group          和这些一样： --[no]break --[no]heading
    -g --filename-pattern PATTERN 打印匹配PATTERN的文件名
    -l --files-with-matches 显示包含匹配的文件名（不显示匹配的行）
    -L --files-without-matches  只显示不包含匹配项的文件名
       --print-all-files    打印所有搜索到的文件的标题，甚至那些不包含匹配的文件。
       --[no]numbers        打印行号。默认情况是在搜索流时省略行号。
    -o --only-matching      只输出每行匹配的部分
       --print-long-lines   在很长的行上打印匹配信息（默认：>2k字符）。
       --passthrough        当搜索一个流时，打印所有的行，即使它们不匹配。
       --silent             抑制所有的日志信息，包括错误
       --stats              打印统计（扫描的文件、花费的时间等）。
       --stats-only         打印统计信息，不打印其他信息（与搜索单个文件时的--计数相同）。
       --vimgrep            像vim的:vimgrep /pattern/g那样打印结果（它报告每一行的匹配结果）
    -0 --null --print0      用null分隔文件名（用于'xargs -0'）。
  
  搜索选项:
    -a --all-types          搜索所有文件（包括隐藏文件）
    -D --debug              可笑的调试（可能没有用）
       --depth NUM          目录搜索最大深度（默认25）
    -f --follow             跟随链接进行搜索
    -F --fixed-strings      为了与grep兼容，--literal的别名。
    -G --file-search-regex  根据正则匹配搜索指定类型的文件
       --hidden             搜索隐藏文件 （但遵从 .*ignore 文件）
    -i --ignore-case        不区分大小写匹配
       --ignore PATTERN     忽略匹配 PATTERN 的文件/目录（也允许使用文字文件/目录名称）
       --ignore-dir NAME    为了与ack兼容，--ignore的别名
    -m --max-count NUM      在一个文件中最大匹配的数量（默认: 10,000）
       --one-device         不跟随其他设备的链接搜索
    -p --path-to-ignore STRING 在STRING使用.ignore文件
    -Q --literal            不要将PATTERN解析为正则表达式
    -s --case-sensitive     敏感地匹配案例
    -S --smart-case         不区分大小写匹配，除非 PATTERN 包含大写字符
       --search-binary      搜索二进制文件
    -t --all-text           搜索所有文本文件（不包括隐藏文件）
    -u --unrestricted       搜索所有文件 （忽略 .ignore, .gitignore, 比如：搜索二进制和隐藏文件）
    -U --skip-vcs-ignores   忽略VCS的忽略文件（指的是 .gitignore，.hgignore；仍然遵从.ignore）。
    -v --invert-match       反向匹配
    -w --word-regexp        只匹配整个单词
    -W --width NUM          在NUM字符后截断匹配行
    -z --search-zip         搜索压缩文件中的内容
  
  文件类型:
  搜索可以限制在某些类型的文件中，例如:
     ag --html needle   结果输出到指定类型文件
     - 在后缀为 .htm、.html、.shtml 或 .xhtml 的文件中搜索“needle”
  
  有关支持的文件类型的列表，可以运行:
    ag --list-file-types  列出支持的文件类型
  

  📋✓

  实例

  列出当前目录下包含 npm 的文件

  shell
  ➜  vue-project ag npm ./
  README.md
  16:npm install
  22:npm run dev
  28:npm run build
  

  📋✓