ag
===

ack 的升级版，C语言编写，更快更人性化

## 补充说明

> 摘自 <https://github.com/ggreer/the_silver_searcher> 项目的 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
```