git grep仅搜索当前Git管理的文件（已提交、已暂存、未暂存），不搜.git、.gitignore排除项及未跟踪新文件；支持--no-index、--include、--exclude、-i、-E、-F等参数扩展功能，可检索历史提交、分支、tag，速度快因纯文本扫描，但默认不递归子模块。
git grep 能搜到哪些文件
它只搜索工作区（包括未暂存、已暂存、已提交）中**当前 Git 管理的文件**，不搜 .git 目录、node_modules、build/ 这类被 .gitignore 排除的路径，也不搜未被 Git 跟踪的新建文件（哪怕你刚 touch foo.js 但没 git add，它就看不见）。
常见错误现象：git grep apiKey 没结果，其实关键词在刚新建的 config.local.js 里——因为没 git add，Git 根本不“认”它。
- 想搜所有文件（含忽略项），得加
-i参数配合--no-index：比如git grep -i --no-index apiKey - 搜特定后缀，用
--include：比如git grep "fetch" --include="*.ts" - 排除某类文件，用
--exclude：比如git grep "console.log" --exclude="*.test.ts"
匹配模式不生效？检查正则和大小写
git grep 默认是基础正则（BRE），不是 Perl 风格；而且默认区分大小写。搜 "Error" 找不到 "error" 或 "ERROR" 是常态。
使用场景：查日志打印、API 错误码、组件名拼写变体时特别容易踩坑。
- 忽略大小写：加
-i，比如git grep -i "notfound" - 启用扩展正则（ERE）：加
-E，支持+、?、|，比如git grep -E "(auth|login)Token" - 固定字符串匹配（更快更准）：加
-F，避免正则元字符被误解释，比如搜"a.b.c"就该用git grep -F "a.b.c"
搜历史提交里的代码（不只是当前分支）
git grep 默认只查 HEAD，也就是当前工作目录状态。如果关键词是上周删掉的函数，或只在 feat/oauth 分支存在过，直接跑命令肯定找不到。
性能影响：跨大量提交搜索会慢，尤其带正则时；建议先用 git log -S 定位变更点，再针对具体 commit 搜。
- 搜某个 commit：
git grep "useSWR" abc1234 - 搜某次 merge 之前的状态：
git grep "axios" origin/main^ - 搜所有本地分支：
git grep "localStorage" refs/heads/* - 搜所有 tag：
git grep "v2." refs/tags/*
为什么有时候比 IDE 搜索还快
因为 git grep 不解析 AST，不加载项目配置，不等 TypeScript 类型检查，它就是纯文本扫——只要 Git 对象数据库里有内容（blob），它就能立刻读取并匹配。
兼容性影响：Windows 上 CMD 可能对引号和反斜杠处理异常，优先用 Git Bash 或 Windows Terminal + WSL；macOS / Linux 无感。
- 搜含空格的短语，必须加引号：
git grep "HTTP status code" - 避免 shell 展开干扰，路径通配符用单引号：
git grep 'TODO' -- '*.py' - 想看行号和文件名对齐，加
-n和--break：git grep -n --break "FIXME"
真正麻烦的是混合了 submodule 的仓库——git grep 默认不进子模块，要搜得显式加 --recurse-submodules，但很多团队根本没开 submodule 的 fetch 权限，这时候就得手动 cd 进去再搜。
