git grep是搜索git仓库中源码文本的最快命令，默认只查当前分支head，不自动遍历历史；需配合rev-list、-i、-e等选项及git log定位上下文。
git grep 是查代码里“写过什么”的最快方式，不是查“谁什么时候改的”——它扫的是工作区/暂存区/历史快照里的**源码文本**，不是提交日志。用错场景，比如想定位某次 fix login timeout 提交，却去 git grep，基本白忙。
git grep 默认只搜当前分支 HEAD，不自动遍历所有提交
很多人跑 git grep "API_KEY" 没结果，第一反应是“没匹配上”，其实更可能是：目标字符串只存在于老分支或已合并但未 rebase 的提交里。默认行为只查 HEAD 所指树对象，不翻历史。
- 查所有已知提交（含 merge 提交）：
git grep "API_KEY" $(git rev-list --all) - 查指定分支范围：
git grep "TODO" main..feature/auth - 查最近 5 次提交：
git grep "console.log" $(git rev-list -n 5 HEAD) - 注意：
git rev-list --all在大仓库可能卡顿，建议加--max-count=100限制
中文、正则、大小写：三个常见失配点
终端编码、Git 配置、shell 转义三者一错，git grep 就静默失败。尤其搜中文时，90% 的“搜不到”其实是终端没设 UTF-8 或 Git 没认出文件编码。
- 强制按 UTF-8 解码（绕过 .gitattributes）：
git -c core.precomposeUnicode=false grep -i "用户登录" - 启用基础正则（非 PCRE）：
git grep -E "(error|fail).*timeout"；-P（Perl 正则）在部分 Git 版本不可用，别硬套 - 大小写敏感是默认行为，搜
"NullPointer"却漏掉"nullpointer"？加-i就行，但注意：文件名本身区分大小写，-i不影响路径匹配 - 搜带空格短语必须加引号：
git grep "load timeout"，不加会当成两个独立词 AND 匹配
结合 git log 定位上下文，别只盯着 grep 输出
git grep 给你的是“在哪行”，但你真正需要的常是“谁在哪次提交改的”。单靠 grep 无法回答后者——它不输出 commit hash、作者、时间。
- 快速补全上下文：
git grep -l "JWT_SECRET" | xargs -I{} git log -n 1 --oneline -- {}（对每个匹配文件，取最近一次修改该文件的提交） - 精准到行级来源：
git blame -L 42,42 src/auth.js | head -1（查第 42 行最后一次变更的提交） - 避免管道误截断：不用
git grep ... | head -10，而用git grep -m 10 "pattern"，前者可能切在中间行导致输出损坏 - 如果目标是“删掉某段逻辑”，
git log -S "function validateToken"比git grep更直接——它专为追踪代码增删设计
最易被忽略的其实是工作区状态：git grep 默认包含未暂存修改，但如果你刚 git add 了部分文件，它就只查暂存区+HEAD，不查其余工作区内容。要确保覆盖全部，显式加 --no-index 或先 git add -A（慎用）。
