用途：用 ripgrep（rg）搜索代码，替代 grep -r 或 find … -exec grep。rg 默认并行遍历、自动跳过 .git/、node_modules/ 与 .gitignore 内容，通常快 5–50 倍。
主要能力与用法：默认使用 rg；按语言/类型用 -t TYPE（如 rg -t go "parseConfig"），不要管道 find 进 rg；用 -g GLOB 过滤路径（-g '!/test/' 排除）。字面量搜索用 -F，含 . ( [ * $ 的字符串必须用 -F 或转义；-w 匹配整词。常用标志：-l 仅列文件、-c 计数、-A/-B/-C 上下文、-o 只输出匹配子串、-i/-s/-S 大小写、--max-count/--max-depth 限制范围、--sort path 稳定输出。跨行仅必要时用 -U（慢）。隐藏/.gitignore 文件用 --no-ignore/--hidden 或 -uu。
机器可读与退出码：工具消费用 --json 输出 NDJSON，事件类型含 begin/match/end/summary；可配 jq 解析，或执行 bash {baseDir}/scripts/rg-json.sh PATTERN PATH。退出码 0 有匹配，1 无匹配（非错误），2 真实错误。
适用场景：定位文件、计数、带上下文查看、提取子串、机器解析。限制：-U 会缓冲整文件且慢；-P 需 PCRE2 支持；无匹配不应视为失败。资料中的示例命令保持原样可用。