Initial commit

skills/toolkit/docs/tools/external/ripgrep.md

@@ -0,0 +1,68 @@
+---
+name: ripgrep
+description: 极速代码搜索工具（rg）- grep的现代化替代品
+category: essential
+tool_id: EXT-RG-001
+---
+
+# ripgrep (rg) ⭐⭐⭐⭐⭐
+
+## 用途
+极速代码搜索，默认递归搜索且遵守.gitignore
+
+## 安装
+
+### macOS
+```bash
+brew install ripgrep
+```
+
+### Ubuntu/Debian
+```bash
+sudo apt-get install ripgrep
+```
+
+## 配置
+```bash
+# 添加到 ~/.bashrc
+alias grep='rg'
+```
+
+## 使用
+
+```bash
+# 搜索Python文件中的TODO
+rg "TODO" -g "*.py"
+
+# 显示上下文（3行）
+rg -A 3 -B 3 "def function_name" app.py
+
+# 统计匹配数
+rg --count "import"
+
+# 搜索并打开文件
+rg "TODO" --files-with-matches | fzf | xargs bat
+```
+
+## 常用选项
+
+- `-i` -- 忽略大小写
+- `-g` -- 文件模式匹配（glob）
+- `-A NUM` -- 显示匹配后NUM行
+- `-B NUM` -- 显示匹配前NUM行
+- `-C NUM` -- 显示匹配前后各NUM行
+- `--count` -- 统计匹配数
+- `--files-with-matches` -- 只显示包含匹配的文件名
+
+## 技巧
+
+```bash
+# 搜索并替换（预览）
+rg "old_function" -S | fzf
+
+# 指定编码
+rg --encoding utf8 "pattern"
+
+# 与fzf集成
+rg "" --files-with-matches | fzf --preview 'rg --color=always "" {}'
+```