对比决策指南
ripgrep 与 ag 对比
新 Agent 工作流和现代仓库搜索优先 ripgrep；已有环境或脚本依赖 ag 时可保留。
工具选择只读ripgrepag
先看决策矩阵
基于官方文档这张表汇总当前注册表和官方来源，不代表两侧已经在同一环境中完成端到端对跑。真正选择前，请用同一个安全样例验证。
| 决策条件 | ripgrep | ag |
|---|---|---|
| 输出合同 | 结构化格式：json, text, null-delimited paths；标志：--json, --null。 | 当前没有为 ag 关联注册表输出记录；决策前检查其官方输出说明。 |
| 认证与身份 | 基础操作无需认证。无需服务凭据；仍应把文件系统和网络访问限制在任务范围内。 | 当前没有为 ag 关联注册表认证记录；使用前检查凭证来源和最小权限。 |
| 可靠性证据 | 证据状态为 verified，文档检查于 2026-07-10；已记录独立测试版本 15.1.0。 | 当前没有为 ag 关联独立执行记录；只能把官方来源当作文档证据。 |
| 更适合 | 通过稳定的 JSON、glob、文件类型和上下文控制快速搜索源码树。 | 当前资料不足以单独判断 ag；先核对官方来源，再用有限、非破坏性样例验证。 |
当前建议
新工作流采用 ripgrep；迁移脚本前测试 Pattern、Ignore 行为和退出码。
目标、输入与输出
在 Agent 选择命令前，先明确要交付的结果和证据。
ripgrep 与 ag 对比：安全执行步骤
每一步都要在已声明的边界内执行，验证输出后再继续。
审批点与回滚
在列出的决策点停下，并让恢复方法始终紧跟操作。
选 CLI、MCP 还是 API？
根据执行位置、身份、输出合同与权限边界选接口。
建议方案
新工作流采用 ripgrep；迁移脚本前测试 Pattern、Ignore 行为和退出码。
官方证据与参考
执行前使用这些官方或上游来源确认当前命令行为。