跳转至

ag

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

补充说明

摘自 https://github.com/ggreer/the_silver_searcher 项目的 Readme.md

  • 它比ack快一个数量级。
  • 它忽略了你的 .gitignore.hgignore 中的文件模式。
  • 如果你的源码库里有你不想搜索的文件,只要把它们的模式添加到一个.ignore文件里。(cough .min.jscough*)
  • 这个命令的名字比ack短33%,而且所有的键都在主行上!

语法

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

选项

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
输出选项:
     --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 的文件

1
2
3
4
5
  vue-project ag npm ./
README.md
16:npm install
22:npm run dev
28:npm run build