ag 搜索工具参数详解

ag 搜索工具参数详解

Ag 是类似ack, grep的工具,它来在文件中搜索相应关键字。

官方列出了几点选择它的理由:

  • 它比ack还要快 (和grep不在一个数量级上)
  • 它会忽略.gitignore和.hgignore中的匹配文件
  • 如果有你想忽略的文件,你需要将它们加入到 .ignore文件中
  • 它的命令名称更短:-)

安装

ubuntu直接安装:

sudo apt install silversearcher-ag

基本使用

ag的基本使用很直接:在命令后面跟要搜索的字符串即可,它会搜索当前目录下所有文本文件,并返回结果。

ag Module

输出:

ag 搜索工具参数详解

可以看到,会有很清晰地高亮输出显示,而且,真的是,非常快

.ignore 文件中指定的文件名会被跳过,不进行搜索。直接把想要忽略的文件名写进去就行:

# .ignore
model.py
trainer.py

详细格式及命令选项

下面介绍一些 ag 的常用参数选项及其含义:

选项 功能
-s / -i / -S 大小写敏感 / 不敏感 / 智能大小写判断(默认),即有大写就开启大小写敏感,否则不敏感
-c count,输出每个文件中有几个匹配字串
-A / -B / -C [NUM] after / before / context,展示匹配到字串的[后/前 / 前后都有] NUM 行,默认2行
-a 搜索全部文件,包括 .ignore 忽略的文件,不包括隐藏文件
-D Output ridiculous amounts of debugging info. Not useful unless you´re actually debugging. (这句是手册原文,笑)
-f 追踪软链接,默认不追踪
-g [PATTERN] 输出匹配 PATTERN 的文件名
-G [PATTERN] 仅搜索文件名匹配 PATTERN 的文件内容
-l / -L 仅输出能 / 不能内容匹配成功的文件的文件名,不输出行内容
-m [NUM] 仅输出前 NUM 次成功匹配的内容,跳过剩下的,默认为0,即全部输出
-r / -n 是 / 否进入目录进行递归搜索,默认会进行递归搜索
-o 只输出行中匹配成功的部分
-p [PATH] 提供指定的 .ignore 文件的路径,默认为当前目录下
-Q 不将 PATTERN 按照正则表达式来解析
-u 搜索所有文件,包括二进制文件,但还是会忽略 .ignore 等文件
-U 忽略 VCS ignore文件(包括.gitignore, .hgignore),但仍然会考虑 .ignore,就是前面两者中的内容会被搜索,但是 .ignore 中的内容还是会被忽略
-w 只匹配整个单词
-V 输出版本信息
-v 匹配所有不包含指定字串的行
z 搜索压缩文件中的内容

另外一些选项:

选项 功能
--ackmate 以可由AckMate解析的格式输出结果
--hidden 搜索隐藏文件,但不会搜索忽略文件,即与 -a 相反
--depth [NUM] 搜索目录深度,-1 为无限制,默认为 25
--ignore PATTERN 忽略名称匹配到 PATTERN 的文件或目录的内容,即与 -G 相反
--[no]break 搜索结果的不同文件之间是否空行,默认空行
--[no]color 是否有颜色高亮显示,默认有
--column 输出列号

这就基本全了,还有一些不是很常用的参数,全部的选项参数可 man ag 来查看。

上一篇:Python warning警告出现的原因及忽略方法


下一篇:Git仓库下.gitignore文件的作用