ripgrep(rg)命令速查
安装与基础搜索、文件与目录过滤、上下文输出、PCRE2 正则、替换与管道、配置与性能、脚本用法与报错排查等 156 条命令
共 156 条命令 · 10 类场景 · 点击右侧图标可复制
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
rg --version | 查看版本与启用的特性(如 PCRE2) | |
rg -h | 常用参数摘要 | |
rg --help | 完整帮助,参数非常多,建议配合 less | |
rg --help | less | 分页阅读,按 / 搜索参数名 | |
apt install ripgrep | Debian/Ubuntu 安装 | |
yum install ripgrep | RHEL/CentOS 安装,需 EPEL | |
brew install ripgrep | macOS 安装 | |
cargo install ripgrep | Rust 工具链安装,可拿到最新版 | |
snap install ripgrep --classic | snap 安装 | |
rg --type-list | 列出内置文件类型与对应扩展名 | |
which -a rg | 确认实际执行的是哪个 rg | |
rg 默认跳过隐藏文件与忽略文件 | 这正是它比 grep -r 快且结果更干净的原因 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
rg TODO | 递归搜索当前目录,自动忽略 .gitignore 中的文件 | |
rg TODO src/ | 限定搜索目录 | |
rg TODO main.go | 只搜单个文件 | |
rg -i error | 忽略大小写 | |
rg -s Error | 强制区分大小写 | |
rg -S error | 智能大小写:全小写时忽略大小写,含大写时精确匹配 | |
rg -F "a.b(c)" | 按字面量搜索,不解析正则元字符 | |
rg -w foo | 整词匹配,避免匹配到 foobar | |
rg -x "func main()" | 整行匹配 | |
rg -v "^#" config.conf | 反向匹配,筛掉注释行 | |
rg -c TODO | 每个文件的匹配行数 | |
rg --count-matches TODO | 每个文件的匹配次数,一行多次也会累加 | |
rg -l TODO | 只输出包含匹配的文件名 | |
rg --files-without-match TODO | 输出不包含匹配的文件 | |
rg -o "v[0-9]+\.[0-9]+" version.txt | 只输出匹配到的片段 | |
rg -n TODO | 显示行号(终端下默认已开启) | |
rg -N TODO | 关闭行号,适合管道输出 | |
rg --column TODO | 额外输出列号 | |
rg -m 3 TODO | 每个文件最多输出 3 条匹配 | |
rg -q TODO && echo found | 静默模式,只用退出码判断是否存在 | |
rg --stats TODO | 输出耗时、文件数、匹配数等统计 | |
rg -e "error" -e "warn" app.log | 多个模式,任一命中即输出 | |
rg -f patterns.txt src/ | 从文件读取多个模式,一行一个 | |
rg -z "error" app.log.gz | 直接搜索 gzip 压缩文件 | |
rg -a "pattern" dump.bin | 把二进制当文本搜索 | |
rg --text "pattern" file.bin | 等价于 -a,跳过二进制检测 | |
rg -p TODO | 美化输出,配合管道时保留颜色与格式 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
rg -g "*.go" TODO | 只搜 go 文件 | |
rg -g "!vendor/**" TODO | 排除目录,感叹号表示排除 | |
rg -g "!*.min.js" -g "!dist/**" TODO | 多个排除规则叠加 | |
rg -g "*.{yaml,yml}" image: | 花括号匹配多种扩展名 | |
rg -t py "def main" | 按内置类型搜索 Python 文件 | |
rg -T js TODO | 排除某类型 | |
rg -t py -T test TODO | 只搜 py,同时排除 test 类型 | |
rg --type-add "web:*.{html,css,js}" -t web TODO | 自定义文件类型,可写进配置文件长期生效 | |
rg --maxdepth 2 TODO | 限制目录深度,避免深挖大仓库 | |
rg --max-filesize 2M TODO | 跳过超大文件 | |
rg --files | 列出所有会被搜索的文件,用于确认范围 | |
rg --files -g "*.md" | 按 glob 列出文件 | |
rg --hidden TODO | 包含隐藏文件与目录 | |
rg --no-ignore TODO | 不遵守 .gitignore 等忽略规则 | |
rg -u TODO | 等价 --no-ignore,只放开一层 | |
rg -uu TODO | 同时搜索隐藏文件 | |
rg -uuu TODO | 连二进制文件一起搜,最彻底也最慢 | |
rg --ignore-file myignore | 额外指定忽略规则文件 | |
rg -L TODO | 跟随符号链接 | |
rg --glob-case-insensitive -g "*.md" TODO | glob 忽略大小写 | |
优先级:命令行 > .rgignore > .ignore > .gitignore | 排查结果缺失时先看忽略规则层级 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
rg -A 3 error app.log | 显示匹配行之后 3 行 | |
rg -B 3 error app.log | 显示匹配行之前 3 行 | |
rg -C 2 error app.log | 前后各 2 行 | |
rg --context-separator="---" -C 2 error | 自定义上下文分隔符 | |
rg --no-heading TODO | 不按文件分组,输出更紧凑 | |
rg --heading TODO | 强制按文件分组显示 | |
rg --vimgrep TODO | 输出 file:line:col:text,编辑器可直接跳转 | |
rg --json TODO | 结构化输出,配合 jq 处理 | |
rg --json TODO | jq -r '.data.path.text?' | 提取匹配到的文件路径 | |
rg --color=always TODO | less -R | 保留颜色分页查看 | |
rg --color=never TODO > out.txt | 写文件时关闭颜色码 | |
rg -r '[$1]' "v([0-9]+)" version.txt | 输出时用捕获组重写匹配内容,不改文件 | |
rg --passthru "^#" app.log | 输出全部行,只高亮匹配部分 | |
rg -0 -l TODO | xargs -0 wc -l | NUL 分隔文件名,路径含空格也安全 | |
rg --field-match-separator="|" TODO | 自定义字段分隔符,便于 awk 处理 | |
rg -C 2 --no-heading TODO | head -50 | 限制输出量,避免刷屏 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
rg "^func \w+\(" main.go | 默认正则引擎,支持常用语法 | |
rg -P "(?<=foo)bar" | PCRE2 引擎,支持后顾断言 | |
rg -P "(?!test)\w+_handler" | 前瞻排除 | |
rg -P "(\w+) \1" | 反向引用,找重复词 | |
rg -P --pcre2-version | 确认 PCRE2 是否被编译进二进制 | |
rg "(?i)error" | 内联标志忽略大小写,可与其他模式组合 | |
rg "\bERROR\b" app.log | 单词边界,避免匹配到 ERROR_CODE | |
rg -U "(?s)select .*?from" queries.sql | 多行匹配,-U 开启跨行模式 | |
rg -U --multiline-dotall "BEGIN.*?END" file | 点号匹配换行,跨段提取 | |
rg "\p{Han}+" notes.txt | 匹配中文字符,PCRE2 与默认引擎均支持 Unicode 属性 | |
rg "^\s*$" file | 找空行 | |
rg --engine pcre2 "pattern" | 显式指定引擎,默认 auto | |
rg -P "\K" 'foo\Kbar' | \K 重置匹配起点,只返回后半段 | |
rg "a|b|c" | 或逻辑,注意用括号控制优先级 | |
默认引擎不支持前后顾 | 遇到 look-around 报错就加 -P |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
rg -l "oldFunc" | xargs sed -i "s/oldFunc/newFunc/g" | 批量替换前的标准姿势:先定位再替换 | |
rg -l "oldFunc" -0 | xargs -0 sed -i "s/oldFunc/newFunc/g" | 路径含空格时用 -0 与 xargs -0 | |
rg -o "\d+" access.log | sort | uniq -c | sort -rn | head | 提取数字并统计 Top N | |
rg -c error app.log | sort -t: -k2 -rn | 按匹配数排序文件,快速定位重灾区 | |
rg --files | fzf --preview "rg --color=always {}" | 模糊选文件并实时预览内容 | |
rg TODO | wc -l | 统计 TODO 行数,做技术债粗算 | |
rg -l TODO | wc -l | 统计涉及文件数 | |
rg "import" --json | jq -r '.data.path.text?' | 结构化提取导入语句所在文件 | |
git ls-files -z | xargs -0 rg -n "pattern" | 只在 git 跟踪的文件中搜索,结果最干净 | |
rg pattern -g "!node_modules/**" --no-heading | 排除依赖目录后输出更聚焦 | |
rg -n pattern | awk -F: '{print $1}' | sort -u | 提取去重后的文件列表 | |
rg --files-with-matches pattern | xargs -n1 dirname | sort -u | 按目录聚合,看影响范围 | |
set -o pipefail | 管道中 rg 无匹配时不被后续命令掩盖 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
RIPGREP_CONFIG_PATH=~/.config/ripgrep/config | 指定配置文件路径,团队可统一默认行为 | |
--smart-case
--hidden
--glob=!.git/* | 配置文件示例:智能大小写并包含隐藏文件 | |
rg --debug TODO | 输出忽略规则与文件遍历过程,排查为什么搜不到 | |
rg --threads 4 TODO | 限制线程数,避免压满 CPU | |
rg --no-mmap TODO | 个别文件系统下 mmap 反而更慢,可关闭 | |
rg -j 1 TODO | 单线程搜索,便于观察性能差异 | |
rg -g "*.go" --maxdepth 3 TODO | 缩小范围是最有效的加速手段 | |
rg --no-ignore-vcs TODO | 只忽略非 VCS 规则,仍读 .gitignore | |
rg --no-messages TODO | 屏蔽权限错误等噪音,输出更干净 | |
rg --files | wc -l | 确认实际参与搜索的文件数量 | |
大仓库先 rg --files -g 缩小范围 | 比全量搜索再过滤快得多 | |
rg 默认多线程并行 | 比 grep -r 快一个量级,且自动跳过二进制与大文件 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
rg -q pattern && echo found | 找到返回 0,未找到返回 1 | |
if rg -q pattern; then echo yes; fi | 脚本中的条件判断写法 | |
rg -q pattern || echo "not found" | 未命中时执行兜底逻辑 | |
echo $? | 0 表示有匹配,1 表示无匹配,2 表示出错 | |
rg --color=never -N pattern | CI 中固定输出格式,便于对比与解析 | |
rg -l pattern | grep -q . | 等价判断是否存在匹配文件 | |
rg pattern file || true | 允许无匹配,避免 set -e 中断脚本 | |
rg -c pattern | awk -F: '{s+=$2} END {print s}' | 汇总所有文件的匹配行数 | |
rg --json | jq -e '.type == "match"' | 结构化断言,适合复杂校验 | |
CI 里配合 --stats 记录搜索耗时 | 仓库变大后能及早发现检索性能退化 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
rg -n "TODO|FIXME" -g "!vendor/**" | 技术债盘点,排除第三方代码 | |
rg -n "^func \w+\(.*\*testing\.T\)" -g "*_test.go" | 列出全部测试函数 | |
rg -n "password|secret|token" -g "!*.md" -g "!test/**" | 敏感信息扫描,输出前注意脱敏 | |
rg -n "\b(\d{1,3}\.){3}\d{1,3}\b" -g "*.conf" | 搜索配置文件中的 IP 地址 | |
rg -n "[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-z]{2,}" -g "!*.min.js" | 搜索邮箱地址 | |
rg -n "listen\s+\d+" /etc/nginx | 排查 Nginx 监听端口配置 | |
rg -n "client_max_body_size" /etc/nginx | 定位影响上传大小的配置项 | |
rg -n "image:" k8s/ -g "*.yaml" | 列出所有镜像,做版本审计 | |
rg -n "OOMKilled|CrashLoopBackOff" logs/ | 日志里快速定位典型故障关键词 | |
rg -n "Connection refused|timeout" logs/ | head -50 | 网络类故障初筛 | |
rg -A 5 "Traceback" app.log | 看异常堆栈的前几行上下文 | |
rg -c " 500 " access.log | 统计 500 错误数量 | |
rg -n "old\.example\.com" -g "!*.log" | 域名迁移前全量排查引用 | |
rg --files-with-matches "deprecated-api" | wc -l | 评估废弃 API 的改造工作量 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
rg: unrecognized flag --xxx | 参数不存在或版本过低,用 rg -h 核对 | |
regex parse error | 正则语法错误,检查括号与转义 | |
look-around, including look-ahead and look-behind, is not supported | 默认引擎不支持,加 -P 启用 PCRE2 | |
backreferences are not supported | 同上,需要 -P | |
Permission denied (os error 13) | 跳过无权限文件,或用 --no-messages 静音 | |
No such file or directory | 路径写错,注意相对路径基准是当前工作目录 | |
error parsing glob | glob 写法有误,注意引号与花括号配对 | |
binary file matches | 命中了二进制文件,用 -a 或加 -g 排除 | |
搜不到但文件里确实有 | 九成是被 .gitignore 或 .ignore 排除,试 -u 或 --debug | |
搜不到隐藏文件内容 | 默认跳过隐藏文件,加 --hidden | |
搜索很慢 | 缩小目录、加 -g/-t、限制 --maxdepth,或 --threads 调整 | |
中文匹配异常 | 确认文件编码为 UTF-8,GBK 文件需先转码 | |
Windows 下引号被吃掉 | PowerShell 用双引号包裹并转义内部双引号 | |
RIPGREP_CONFIG_PATH 指向不存在的文件 | 不会报错但配置不生效,检查路径拼写 | |
输出里混入颜色码 | 写文件或解析时加 --color=never | |
rg 与 grep -r 结果不同 | rg 默认遵守忽略规则并跳过隐藏/二进制文件,属预期行为 |
运维常用组合
rg -n "TODO|FIXME" -g "!vendor/**" -g "!node_modules/**" | wc -lrg -l "oldFunc" -0 | xargs -0 sed -i "s/oldFunc/newFunc/g" → 再 rg 复查是否还有残留rg -n "ERROR|Timeout" app.log -C 2 | head -80rg -n "password|secret|BEGIN RSA" -g "!*.md" -g "!test/**"rg -n "image:" k8s/ -g "*.yaml" | awk -F: "{print $3}" | sort -urg -q "license" -g "*.go" || { echo "缺少 license 头"; exit 1; }实战要点
1. 默认就够快
自动多线程、跳过二进制与忽略文件,多数场景直接 rg 比 grep -r 更合适
2. 先限定范围
用 -g/-t/--maxdepth 缩小搜索面,比加大线程数更能提速
3. 搜不到先看忽略规则
被 .gitignore 排除是最高频原因,用 --debug 或 -u 验证
4. 替换前先 -l
先用 rg -l 定位文件清单,再交给 sed,避免误伤
5. 前后顾要加 -P
默认引擎不支持 look-around,报错时直接想到 PCRE2
6. 脚本里用 -q 与 --color=never
退出码判断逻辑清晰,输出也不会被颜色码污染
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于ripgrep(rg)命令速查
在线 ripgrep(rg)命令速查手册,按安装与版本、基础搜索、文件过滤、输出与格式化、正则与 PCRE2、替换与管道组合、配置与性能、退出码与脚本、实战场景、常见报错与排查等 10 类场景整理 150 余条常用命令与参数组合,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 rg --version 与 apt/yum/brew/cargo/snap 安装与 rg --type-list、rg pattern 与 -i/-s/-S 大小写与智能大小写 与 -F 固定串 与 -w 整词 与 -x 整行 与 -v 取反 与 -c/--count-matches 计数 与 -l/--files-without-match 只列文件名 与 -o 只输出匹配 与 -n/-N 行号 与 --column 列号 与 -A/-B/-C 上下文 与 -m 每文件上限 与 -e 多模式 与 -f 模式文件 与 -q 静默 与 --stats 统计 与 -z 压缩文件 与 -a/--text 二进制、-g glob 包含与 ! 排除 与 -t/--type 与 -T 排除类型 与 --type-add 自定义类型 与 --maxdepth 与 --max-filesize 与 --files 列文件 与 --hidden 与 --no-ignore 与 -u/-uu/-uuu 与 --ignore-file 与 .rgignore/.ignore/.gitignore 优先级 与 -L 跟随软链、--json 输出 与 --vimgrep 与 --color 与 -r 捕获组替换输出 与 --passthru 全量输出 与 --context-separator 与 -0 NUL 分隔 与 --stats 汇总,以及 -P/--pcre2 支持前后瞻与反向引用 与 (?s) 多行 与 -U 跨行匹配 与 \p{Han} Unicode 属性 与 --engine 选择引擎,还有 rg -l | xargs sed -i 批量替换、rg -o | sort | uniq -c 统计、rg --files | fzf 交互选择、RIPGREP_CONFIG_PATH 与 ~/.config/ripgrep/config 配置、--threads/--mmap 性能调优,以及 unrecognized flag、regex parse error、look-around not supported(需 -P)、Permission denied、binary file matches、glob 解析失败、搜索变慢、Windows 引号与路径等报错排查。适用于代码库全文检索与重构前定位、日志与配置排查、敏感信息扫描、批量替换前的引用统计、CI 中基于退出码做内容校验,以及运维、SRE 与后端工程师面试复习。
核心能力
- 涵盖 rg --version 与 apt/yum/brew/cargo/snap 安装与 rg --type-list、rg pattern 与 -i/-s/-S 大小写与智能大小写 与 -F 固定串 与 -w 整词 与 -x 整行 与 -v 取反 与 -c/--count-matches 计数 与 -l/--files-without-match 只列文件名 与 -o 只输出匹配 与 -n/-N 行号 与 --column 列号 与 -A/-B/-C 上下文 与 -m 每文件上限 与 -e 多模式 与 -f 模式文件 与 -q 静默 与 --stats 统计 与 -z 压缩文件 与 -a/--text 二进制、-g glob 包含与 ! 排除 与 -t/--type 与 -T 排除类型 与 --type-add 自定义类型 与 --maxdepth 与 --max-filesize 与 --files 列文件 与 --hidden 与 --no-ignore 与 -u/-uu/-uuu 与 --ignore-file 与 .rgignore/.ignore/.gitignore 优先级 与 -L 跟随软链、--json 输出 与 --vimgrep 与 --color 与 -r 捕获组替换输出 与 --passthru 全量输出 与 --context-separator 与 -0 NUL 分隔 与 --stats 汇总,以及 -P/--pcre2 支持前后瞻与反向引用 与 (?s) 多行 与 -U 跨行匹配 与 \p{Han} Unicode 属性 与 --engine 选择引擎,还有 rg -l | xargs sed -i 批量替换、rg -o | sort | uniq -c 统计、rg --files | fzf 交互选择、RIPGREP_CONFIG_PATH 与 ~/.config/ripgrep/config 配置、--threads/--mmap 性能调优,以及 unrecognized flag、regex parse error、look-around not supported(需 -P)、Permission denied、binary file matches、glob 解析失败、搜索变慢、Windows 引号与路径等报错排查
适用场景
适用于代码库全文检索与重构前定位、日志与配置排查、敏感信息扫描、批量替换前的引用统计、CI 中基于退出码做内容校验,以及运维、SRE 与后端工程师面试复习。ripgrep(rg)命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。
常见问题
- ripgrep(rg)命令速查是免费的吗?需要注册或安装吗?
- ripgrep(rg)命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
- ripgrep(rg)命令速查支持哪些功能?
- 涵盖 rg --version 与 apt/yum/brew/cargo/snap 安装与 rg --type-list、rg pattern 与 -i/-s/-S 大小写与智能大小写 与 -F 固定串 与 -w 整词 与 -x 整行 与 -v 取反 与 -c/--count-matches 计数 与 -l/--files-without-match 只列文件名 与 -o 只输出匹配 与 -n/-N 行号 与 --column 列号 与 -A/-B/-C 上下文 与 -m 每文件上限 与 -e 多模式 与 -f 模式文件 与 -q 静默 与 --stats 统计 与 -z 压缩文件 与 -a/--text 二进制、-g glob 包含与 ! 排除 与 -t/--type 与 -T 排除类型 与 --type-add 自定义类型 与 --maxdepth 与 --max-filesize 与 --files 列文件 与 --hidden 与 --no-ignore 与 -u/-uu/-uuu 与 --ignore-file 与 .rgignore/.ignore/.gitignore 优先级 与 -L 跟随软链、--json 输出 与 --vimgrep 与 --color 与 -r 捕获组替换输出 与 --passthru 全量输出 与 --context-separator 与 -0 NUL 分隔 与 --stats 汇总,以及 -P/--pcre2 支持前后瞻与反向引用 与 (?s) 多行 与 -U 跨行匹配 与 \p{Han} Unicode 属性 与 --engine 选择引擎,还有 rg -l | xargs sed -i 批量替换、rg -o | sort | uniq -c 统计、rg --files | fzf 交互选择、RIPGREP_CONFIG_PATH 与 ~/.config/ripgrep/config 配置、--threads/--mmap 性能调优,以及 unrecognized flag、regex parse error、look-around not supported(需 -P)、Permission denied、binary file matches、glob 解析失败、搜索变慢、Windows 引号与路径等报错排查。
- ripgrep(rg)命令速查适合哪些场景使用?
- 适用于代码库全文检索与重构前定位、日志与配置排查、敏感信息扫描、批量替换前的引用统计、CI 中基于退出码做内容校验,以及运维、SRE 与后端工程师面试复习。