git grep 默认搜索HEAD和工作区中被Git跟踪的文件，速度快、结果干净；支持指定范围如--cached、提交哈希、--branches等；不搜.gitignore文件，未跟踪文件需--no-index；不支持PCRE正则；配合git log -S可追溯字符串变更历史。
git grep 能直接搜整个仓库，比先 git checkout 再用系统 grep 快得多
它只扫描 Git 索引和工作区里被 Git 跟踪的文件（默认不搜 .gitignore 里的），所以结果干净、速度快，尤其适合在大型项目里找函数调用或配置项。如果搜不到，大概率是文件没被跟踪，或者你忘了加 -i 忽略大小写。
- 默认只搜当前分支的 HEAD 和工作区；加
--no-index可搜未跟踪文件（但会变慢） - 想搜历史提交？用
git grep <pattern> $(git rev-list --all)，不过 commit 多时很卡，慎用 -
git grep不支持正则中的 \K 或 lookahead，PCRE 特性一概不认，老实用基础正则或-E
区分搜索范围：工作区、暂存区、某次提交
很多人以为 git grep 总是搜全部，其实它默认行为取决于有没有指定树对象（tree-ish）。不加参数就是“HEAD 加工作区”，但你可以精准控制。
- 只搜暂存区：
git grep <pattern> --cached - 只搜某次提交：
git grep <pattern> a1b2c3d（a1b2c3d是 commit hash） - 搜所有分支最新提交：
git grep <pattern> --branches（注意不是--all） - 搜某个子目录：
git grep <pattern> -- src/utils/，路径必须存在且被跟踪
常见报错：fatal: no match 却明明有内容
这不是 bug，是 git grep 的严格模式在起作用——它拒绝在空仓库、无提交的分支、或完全未跟踪文件的目录里执行搜索。
- 刚
git init还没git add？会报这个错；先git add . && git commit -m "init"再试 - 搜的是二进制文件（比如
.png）？默认跳过；加-a强制文本解析（可能乱码，但能出结果） - 用了
-n显示行号却没输出？说明匹配行在未跟踪文件里，加--no-index或确认文件是否git add过 - 中文路径或文件名乱码？终端编码和 Git 配置不一致，临时加
export LC_ALL=C再试
配合 git log -S 找字符串首次/末次出现的提交
git grep 定位“在哪”，git log -S 定位“从哪来”。比如你想知道 API_TIMEOUT 是谁、什么时候加进来的，git grep 找到位置后，立刻补一句：
git log -S "API_TIMEOUT" --oneline
注意：-S 是按“出入行差异”匹配（即该字符串在某次提交中首次出现或彻底消失），不是全文本搜索；如果想按补丁内容搜，得用 -G + 正则。
-
-S对重命名敏感，文件改名后可能搜不到；-G更稳，但更慢 - 想限制时间范围？加
--since="2 weeks ago"，避免翻几百个 commit - 搜常量定义时，建议连等号一起写：
git log -S "const VERSION ="，减少误命中
实际用的时候，最常漏掉的是路径过滤和大小写。搜 useEffect 却漏了 useeffect 或 USEEFFECT，加个 -i 就省十分钟。还有人习惯把 git grep 当成万能全文搜，忘了它天然过滤掉 .gitignore 里的内容——真要搜 node_modules 或 build 目录，不如直接 grep -r。
