日常代码搜索优先用ag，因其默认跳过.git等目录和二进制文件，比grep-r少扫70%以上路径；无安装条件时才退用grep-r。
直接结论：日常代码搜索，优先用 ag；没有安装条件或需兼容老旧环境时，才退回到 grep -r 加一堆参数凑合用。
为什么 ag 比 grep -r 快得多
根本原因不在“算法多玄妙”，而在于默认行为差异：ag 启动时就跳过 .git、node_modules、__pycache__ 等目录，也不扫描二进制文件；grep -r 默认扫一切，包括你根本不想碰的 200MB 的 vendor/ 或打包后的 .min.js。
实操建议：
- 运行
ag --stats可看到它实际搜索了多少文件、跳过了多少——通常比grep -r少扫 70% 以上路径 -
grep -r要达到类似效果，得手动写：grep -r --exclude-dir={node_modules,.git,venv} --binary-files=without-match，极易漏写、难复用 - 如果你在项目根目录下执行
ag foo，它自动按.gitignore过滤；grep完全不认这个文件
ag 和 grep 的常见参数映射关系
迁移到 ag 不需要重学，多数场景只需替换命令名+微调参数：
- 查字符串并显示行号：
ag -n foo≈grep -rn foo - 只搜 Python 文件：
ag --py foo≈grep -r --include="*.py" foo - 忽略大小写：
ag -i foo≈grep -ri foo - 只输出匹配文件名（不显示内容）：
ag -l foo≈grep -rl foo - 反向搜索（不含某词）：
ag -L bar（注意是大写 L）≠grep -v，因为ag -L是“整个文件都不含”，不是“某行不含”
⚠️ 注意：ag 不支持 grep -A/-B（上下文行），也没 grep -o（仅输出匹配部分）；真需要这些，得切回 grep 或用 rg（ripgrep）替代。
Browser Setup (No-Root Linux)
下载
在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...
什么时候必须用 grep，而不是 ag
不是所有场景 ag 都能覆盖，硬上反而踩坑：
- 系统无权限装第三方工具（如某些受限容器、CI 构建镜像），
grep是唯一选择 - 要处理压缩包内文本（如
zgrep查.gz日志），ag不支持 - 正则表达式需用 PCRE 高级特性（如条件断言、递归模式），
ag的 regex 引擎较旧，可能报invalid regex - 搜索目标是设备文件、socket 或特殊字符文件（如
/proc/kmsg），ag默认跳过，且无法用--no-ignore完全放开
一个典型陷阱：ag --no-ignore -g "*.log" | xargs grep ERROR 看似想先列日志再过滤，但 ag -g 输出的是相对路径，xargs grep 在子目录下执行时容易报 No such file——这种组合不如直接 grep -r ERROR --include="*.log" 稳定。
安装和最小化配置建议
ag 安装极轻量，但别忽略这三件事：
- Ubuntu/Debian：
sudo apt install silversearcher-ag；macOS：brew install the_silver_searcher；Arch：sudo pacman -S the_silver_searcher - 加一行到
~/.bashrc：alias ag='ag --color-line-number=1;33 --color-match=1;31'，避免每次输颜色参数 - 如果项目没
.gitignore但你想跳过某些目录，建个.agignore（格式同.gitignore），ag会自动读取
最常被忽略的一点：很多团队把 ag 当成“更快的 grep”就完事了，但它真正的价值在于**减少干扰路径的决策成本**——你不需要每次搜索前都回忆“这次要不要加 --exclude-dir”，ag 已经替你做了。这点省下的注意力，长期看比几毫秒速度提升重要得多。
