GeekIt

ripgrep(rg)命令速查

安装与基础搜索、文件与目录过滤、上下文输出、PCRE2 正则、替换与管道、配置与性能、脚本用法与报错排查等 156 条命令

共 156 条命令 · 10 类场景 · 点击右侧图标可复制

命令 / 片段说明复制
rg --version查看版本与启用的特性(如 PCRE2)
rg -h常用参数摘要
rg --help完整帮助,参数非常多,建议配合 less
rg --help | less分页阅读,按 / 搜索参数名
apt install ripgrepDebian/Ubuntu 安装
yum install ripgrepRHEL/CentOS 安装,需 EPEL
brew install ripgrepmacOS 安装
cargo install ripgrepRust 工具链安装,可拿到最新版
snap install ripgrep --classicsnap 安装
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" TODOglob 忽略大小写
优先级:命令行 > .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 -lNUL 分隔文件名,路径含空格也安全
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 patternCI 中固定输出格式,便于对比与解析
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 globglob 写法有误,注意引号与花括号配对
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 -l
批量替换rg -l "oldFunc" -0 | xargs -0 sed -i "s/oldFunc/newFunc/g" → 再 rg 复查是否还有残留
日志排障rg -n "ERROR|Timeout" app.log -C 2 | head -80
敏感信息扫描rg -n "password|secret|BEGIN RSA" -g "!*.md" -g "!test/**"
K8s 清单审计rg -n "image:" k8s/ -g "*.yaml" | awk -F: "{print $3}" | sort -u
CI 内容校验rg -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

退出码判断逻辑清晰,输出也不会被颜色码污染

共 156 条 ripgrep 命令 · 示例中的路径与模式请替换为实际环境

关于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 与后端工程师面试复习。