ripgrep 快速上手命令行文件搜索的安装方法与 4 个高频场景【免费下载链接】ripgrepripgrep recursively searches directories for a regex pattern while respecting your gitignore项目地址: https://gitcode.com/GitHub_Trending/ri/ripgrepripgrep缩写 rg是一款基于正则表达式的文件搜索工具递归扫描目录时自动遵守 .gitignore。反直觉的一点它默认不搜的东西比它搜的更值得先了解。装好、会用、会排查搜不到这一篇就够。先搞懂 ripgrep 的三个默认行为rg 搜得快又干净全靠三条默认过滤规则不先懂它们后面排查搜不到全靠猜。遵守 .gitignoregit 忽略的文件构建产物、依赖目录等直接跳过。好处是结果只跟版本管理的内容相关副作用是文件一旦进了 .gitignore默认就搜不到。跳过隐藏文件以点开头的文件和目录如 .git、.config不进入扫描。结果保持干净但隐藏目录里的内容需要显式打开才能搜。跳过二进制文件图片、压缩包、可执行文件一律不扫避免刷屏和拖慢速度。想搜压缩包里的一段文本默认是搜不到的。按需求选择安装方式包管理器还是源码编译装之前先想清楚要哪个版本求稳用包管理器一行搞定要最新特性或 PCRE2 再自己编译。求稳路线包管理器。依赖自动处理、随时可升级版本可能比官方发布略旧对大多数人足够系统安装命令macOSbrew install ripgrepUbuntu / Debiansudo apt-get install ripgrepArch Linuxsudo pacman -S ripgrepFedora / RHELsudo dnf install ripgrepWindowschoco install ripgrep或scoop install ripgrep尝鲜路线源码编译。共四步克隆仓库git clone https://gitcode.com/GitHub_Trending/ri/ripgrep用 rustup 安装 Rust 工具链并加载环境变量cargo build --release编译出二进制把target/release/rg放进 PATH 中的目录如/usr/local/bin想要 PCRE2支持后向引用等高级语法编译时加--features pcre2它是 Cargo.toml 中声明的可选特性。装完跑一条命令验证rg --version能看到版本号当前 15.x即安装成功输出里还列着 SIMD、PCRE2 等编译特性的开关状态。四个高频搜索场景记住下面四个场景日常搜索基本不用再查手册。全盘找内容需求在当前目录里找出某段内容出现在哪些文件。命令rg pattern为什么有效递归扫描当前目录同时自动避开被 git 忽略的文件结果默认就是干净的。按类型或目录找需求只搜 Rust 文件或只搜匹配某个通配规则的文件。命令rg -t rust fn main换通配规则则用rg -g *.rs TODO为什么有效-t限定文件类型rg --type-list可看全部类型-T排除类型-g按 glob 过滤范围先收窄再匹配速度更快。带上下文精确定位需求光看匹配行不够要连着前后代码一起看明白。命令rg -n -C 2 panic为什么有效-n显示行号方便编辑器跳转-C 2前后各带 2 行想更细可用-A 3、-B 2-H强制显示文件名。先看扫描范围再搜需求不确定会扫到哪些文件先确认范围再动手。命令rg --files为什么有效只列出会被搜索的文件不搜内容配合--max-depth 3限制递归深度范围可控后再精确搜。没搜到结果逐个关掉默认过滤搜不到多半不是 bug而是默认过滤在生效。按下面顺序逐个排除在隐藏文件里.git等隐藏目录默认跳过--hidden打开。在二进制文件里默认跳过-uu连二进制一起搜。被 .gitignore 忽略了从-u开始逐步关闭过滤-uuu把隐藏、二进制、忽略规则全部放开。只想关忽略规则、保留跳过二进制用--no-ignore比-uuu范围更窄。-uuu是无差别搜索大仓库里会明显变慢找到原因后尽早收窄条件。组合配方速查记不住参数组合下面这几条可以直接照抄配方什么时候用效果rg pattern在当前目录找内容递归搜索自动避开 git 忽略的文件rg -t rust fn main只搜指定类型的文件按文件类型限定范围rg -i -w TODO大小写混写、只要整词忽略大小写且整词匹配不会命中 TODOListrg -n -A 3 err想看匹配行之后的代码显示行号及后 3 行rg -g *.rs impl 用通配规则过滤文件只搜 .rs 文件rg --files先确认会扫到哪些文件只列文件不搜内容rg -uu pattern怀疑内容藏在二进制里连二进制文件一起搜在一个干净的 git 仓库里rg xxx基本就是只搜该搜的这也是它比传统工具快的原因。想继续深入可以研究-t与-g的组合给自己攒几个搜索预设。延伸阅读项目概览README.md完整用户指南GUIDE.md常见问题解释为什么默认跳过二进制FAQ.md帮助文本源码crates/core/flags/doc/help.rs【免费下载链接】ripgrepripgrep recursively searches directories for a regex pattern while respecting your gitignore项目地址: https://gitcode.com/GitHub_Trending/ri/ripgrep创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考