前言
说到文本搜索工具，大家一定会知道 grep, 它是 linux 最有用并最常用的工具之一。
但如果要再一个大的工程项目中搜索某个关键词，大家也一定知道它比较耗时。
所以就有了很多替代工具，之前最出名的是 Ack，Ag
而最近又有了新的替代者 Ripgrep, 这个工具和 Ack/Ag 一样都使用了多线程的方法，但 rg 比它们更快
简介
ripgrep 是一个以行为单位的搜索工具， 它根据提供的 pattern 递归地在指定的目录里搜索。它是由 Rust 语言写成，相较与同类工具，它的特点就是无与伦比地快。
几个特点如下：
安装 ripgrep
先安装 RUST
curl https://sh.rustup.rs -sSf | sh
然后一路 enter 就好了
用 RUST 安装 rigpre
git clone https://github.com/BurntSushi/ripgrep cd ripgrep cargo build --release cp ./target/release/rg /usr/local/bin/
最后一步根据你的情况把它放到某个在 PATH 里的路径里
使用
搜索结果展示
用法总体格式
USAGE: rg [OPTIONS] PATTERN [PATH ...] rg [OPTIONS] [-e PATTERN ...] [-f PATTERNFILE ...] [PATH ...] rg [OPTIONS] --files [PATH ...] rg [OPTIONS] --type-list command | rg [OPTIONS] PATTERN
输入参数
ARGS:
<PATTERN>
A regular expression used for searching. To match a pattern beginning with a
dash, use the -e/--regexp flag.
For example, to search for the literal '-foo', you can use this flag:
rg -e -foo
You can also use the special '--' delimiter to indicate that no more flags
will be provided. Namely, the following is equivalent to the above:
rg -- -foo
<PATH>...
A file or directory to search. Directories are searched recursively. Paths specified on
the command line override glob and ignore rules.
| options | Description | other |
|---|---|---|
| -A, --after-context <NUM> | 显示匹配内容后的<NUM>行 | 会覆盖--context |
| -B, --before-context <NUM> | 显示匹配内容前的<NUM>行 | 会覆盖--context |
| -b, --byte-offset | 显示匹配内容在文件中的字节偏移 | 和-o 一起使用，只打印偏移 |
| -s, --case-sensitive | 大小写敏感 | 会覆盖-i(ignore case), -S(smart case) |
| --color <WHEN> | 什么时候使用颜色，默认 auto | 如果--vimgre 被使用，那么默认值是 never |
| 可选项有： never, auto, always, ansi | ||
| --colors <COLOR_SPEC>... | 设定输出颜色： | color: red, blue, green, cyan |
{type}:{attribute}:{value} |
magenta, yellow, white, black | |
{type}: path, line, column, match |
style: nobold, bold, nointense | |
{attribute}: fg, bg, style |
intense, nounderline, underline | |
{value}: a color or a text style |
Example: | |
{type}:none会清空{type}的颜色设定 |
rg --colors 'match:fg:magenta' --colors 'line:bg:yellow' foo | |
扩展颜色集可以被{value}使用，如果终端支持 ANSI color |
||
| 描述方法是'x'(256-color) 或 'x,x,x'(24-bit true color) | ||
| x 是 0-255 之间的数值,默认是 10 进制， 0x 前缀是 16 进制 | ||
| 比如: rg --colors 'match:bg:0,128,255' | ||
| 或者等价的：rg --colors 'match:bg:0x0,0x80,0xFF' | ||
| 在使用 extended color code 时 intense 和 nointense 是无效的 | ||
| --column | 第一次匹配所在列数(从 1 开始) | 能够被--no-column 取消掉 |
| -C, --context <NUM> | 显示匹配内容的前面和后面的<NUM>行 | 它会覆盖-B 和-A 选项 |
| --context-separator <SEPARATOR> | 在输出中用来分隔非连续的行 | x7F 或t 可被使用，默认是-- |
| -c, --count | 只显示匹配的行数 | 如果只有一个文件给 ripgrep，那只打印匹配行数 |
| 可以用--with-filename 来强制打印文件名 | ||
| 它会覆盖--count-matches 选项 | ||
| --count-matches | 只显示匹配的次数 | 可以用--with-file 来强制在只有一个文件时也输出文件名 |
| --debug | 显示调试信息 | |
| --dfa-size-limit <NUM+SUFFIX?> | regex DFA 的上限， 默认 10M | |
| -E, --encoding <ENCODING> | 描述文本编码, 默认是 auto | https://encoding.spec.whatwg.org/#concept-encoding-get |
| -f, --file <PATTERNFILE>... | 从文件中读入 pattern, 一行一 pattern | 可以被多次使用或和-e 一起组合使用，所以有组合会被匹配 |
| --files | 打印所有将被搜索的文件 | 以rg <options> --files [PATH...]方式使用，不能加 pattern |
| -l, --files-with-matches | 只打印有匹配的文件名 | 覆盖--files-without-match |
| --files-without-match | 只打印无匹配的文件名 | 覆盖 --file-with-matches |
| -F, --fixed-strings | 把 pattern 当成常规文字而非 regex | 可以用--no-fixed-strings 来禁止这个选项 |
| -L, --follow | 会递归搜索链接，默认关闭 | 可以用--no-follow 来关闭 |
| -g, --glob <GLOB>... | 通配符文件或文件夹，可以用!来取反 | 可以多次使用， 会匹配.gitignore 的通配符规则 |
| -h, --help | 打印帮助信息 | |
| --heading | 打印文件名到匹配内容的上方而不是同一行 | 这是默认行为，可以用--no-heading 来关闭 |
| --hidden | 搜索隐藏文件和文件夹 | 默认忽略, 可用--no-hidden 关闭 |
| --iglob <GLOB>... | 同--glob, 但这个大小写不敏感 | |
| -i, --ignore-case | pattern 大小写不敏感 | 可通过-s/--case-sensitive 或-S/--smart-case 覆盖这个选项 |
| --ignore-file <PATH>... | 忽略路径，格式同.gitignore, 可多个 | 多个--ignore-file 标记时，后面优先级高 |
| 在命令上时，使用-g 来达到同样效果 | ||
| -v, --invert-match | 反向匹配 | |
| -n, --line-number | 显示文件行数，默认打开 | |
| -x, --line-regexp | 只显示整行都匹配 pattern 的行 | 会覆盖--word-regexp |
| -M, --max-columns <NUM> | 不打印长于<NUM>列的匹配行 | |
| -m, --max-count <NUM> | 限制一个文件最多<NUM>行匹配 | |
| --max-depth <NUM> | 限制文件夹递归搜索深度 | rg --max-depth 0 dir/不执行任何搜索 |
| --max-filesize <NUM+SUFFIX?> | 忽略大于<NUM>byte 的文件 | suffix 可以是 K, M，G, 默认是 byte |
| --mmap | 尽量使用 memory maps, 默认行为 | 目前它不支持所有选项, 用--no-mmap 来关闭 |
| --no-config | 不读取 conf 文件, 忽略 RIPGREP_CONFIG_PATH | |
| --no-filename | 不要打印匹配文件名 | |
| --no-heading | 在每个匹配行前都打印文件名 | |
| --no-ignore | 取消 ignore 文件，如.gitignore, .ignore | 可以用--ignore 关闭 |
| --no-ignore-global | 取消对全局的 ignore 文件读取 | 如$HOME/.config/git/ignore |
| --no-ignore-messages | 取消解析.ignroe, .gitignore 文件相关错误 | 可通过--ignore-messages 关闭 |
| --no-ignore-parent | 不读取父文件夹里的.gitignore, .ignore 文件 | 可通过 --ignore-parent 关闭 |
| --no-ignore-vcs | 只全能.ignore 文件 | 可通过--ignore-vcs 关闭 |
| -N, --no-line-number | 不打印匹配行数 | |
| --no-messages | 不打印打开和读取文件相关错误 | |
| -0, --null | 在打印的文件路径后加一个 NUL 字符 | 对于 xargs 非常有用 |
| -o, --only-matching | 只打印匹配的内容，而不是整行 | |
| --passthru | 打印匹配和不匹配的行 | |
| --path-separator <SEPARATOR> | 路径分隔符，在 linux 上默认是/ | |
| --pre <COMMAND> | 用<COMMAND>处理文件，并将结果给 rg | 可能有巨大的性能惩罚 |
| 例如 | ||
| case "$1" in | ||
| *.pdf) | ||
| exec pdftotext "$1" - | ||
| ;; | ||
| *) | ||
| case $(file "$1") in | ||
| _Zstandard_) | ||
| exec pzstd -cdq | ||
| ;; | ||
| *) | ||
| exec cat | ||
| ;; | ||
| esac | ||
| ;; | ||
| esac | ||
| -p, --pretty | --color always --heading --line-number |
|
| -q, --quiet | 不打印到 stdout, 如果匹配发现，停止 rg | 当 rg 用于 exit 代码时非常有用 |
| --regex-size-limit <NUM+SUFFIX?> | 编译 regex 的上限 | |
| -e, --regexp <PATTERN>... | 使用正则来匹配 | 可多次使用这个选项，打印匹配任何 pattern 的行 |
可以用于搜索-开头的 pattern，如rg -e -foo |
||
| -r, --replace <REPLACEMENT_TEXT> | 用相应文件代替匹配内容打印出来 | 组序号($5)可以被使用 |
| -z, --search-zip | 在 gz,bz2,xz,lzma,lz4 文件类型中搜索 | 可通过--no-search-zip 关闭 |
| -S, --smart-case | 如果全小写，则大小写不敏感，否则敏感 | 可通过-s/--case-sensitive 和-i/--ignore-case 关闭 |
| --sort-files | 根据文件路径排序输出结果 | 会关闭并行搜索线程 |
| --stats | 打印出统计结果 | |
| -a, --text | 搜索二进制文件 | 可通过--no-text 关闭 |
| -j, --threads <NUM> | 大约使用的线程数 | |
| -t, --type <TYPE>... | 只搜索某种文件类型 | 可通过--type-lsit 来列出支持的文件类型 |
| --type-add <TYPE_SPEC>... | 添加文件类型 | 如rg --type-add 'foo:*.foo' -tfoo PATTERN |
| 也可以用来创建某种包含多种文件类型的规则 | --type-add 'src:include:cpp,py,md' | |
| --type-clear <TYPE>... | 清除默认的文件类型 | |
| --type-list | 列出所有内置文件类型 | |
| -T, --type-not <TYPE>... | 不要搜索某种文件类型 | |
| -u, --unrestricted | -u 搜索.gitignore 里的文件, -uu 搜索隐藏文件 | -uuu 搜索二进制文件 |
| -V, --version | 打印版本信息 | |
| --vimgrep | 每一次匹配打印一行 | 一行有多次匹配会打印多行 |
| -H, --with-filename | 打印匹配的文件路径，默认 | 可通过--no-filename 关闭 |
| -w, --word-regexp | 把 pattern 作为单独单词匹配，与< >等价 |
