git grep只搜索被Git跟踪的文件（HEAD、--cached及已暂存/已提交的工作区文件），不搜未跟踪文件、.gitignore路径及.git目录；默认区分大小写且用基础正则，需加-i、-F、-E等参数适配需求，并显式指定tree-ish才能搜索历史提交、分支或tag。
git grep 不是“增强版系统 grep”，它是 Git 仓库语义下的精准文本探针——只认被 git add 过的文件，不看 .gitignore 里的路径，也不理刚新建还没提交的文件。搜不到？八成是文件没被跟踪，或者大小写/正则写错了。
为什么 git grep apiKey 没结果，但文件里明明有？
最常见原因：目标文件（比如 config.local.js）是刚 touch 出来的，还没 git add，Git 根本不“知道”它存在。git grep 默认只查三类内容：HEAD（已提交）、--cached（已暂存）、工作区中已被跟踪的文件（即之前 git add 过、现在又改了的）。未跟踪文件直接被跳过。
- 确认文件是否被跟踪：
git status --ignored看它是否列在 “Untracked files” 下 - 临时搜全部（含未跟踪）：
git grep -i --no-index apiKey，但会变慢，且可能扫到node_modules等噪音 - 真要长期搜这类文件，先
git add config.local.js再搜，更符合协作规范
git grep 默认区分大小写，且用基础正则（BRE）
搜 "Error" 找不到 "error" 或 "ERROR" 是设计如此，不是 bug；写 api\.v2 却匹配到 apiV2，是因为点号 . 被当成了正则通配符。
- 忽略大小写：固定加
-i，例如git grep -i "notfound" - 搜字面量（避免正则干扰）：用
-F，例如git grep -F "a.b.c"，比git grep "a\.b\.c"更安全、更快 - 需要
+、?、|等语法？加-E启用扩展正则：git grep -E "(auth|login)Token" - BRE 不支持
\K、lookahead 等 PCRE 特性，别硬套 Perl 正则
怎么搜历史提交、分支、tag，而不是只搜当前 HEAD？
默认行为就是只查 HEAD + 工作区，想查别的必须显式指定 tree-ish。不写范围，就永远看不到上周删掉的函数、或只在 feat/oauth 分支里存在的配置项。
- 搜某次提交：
git grep "useSWR" abc1234（abc1234是 commit hash） - 搜所有本地分支最新提交：
git grep "localStorage" refs/heads/* - 搜所有 tag：
git grep "v2." refs/tags/* - 搜某分支合并前的状态：
git grep "axios" origin/main^（注意^） - 慎用
$(git rev-list --all)：commit 太多时极慢，建议先用git log -S "API_TIMEOUT" --oneline定位大致范围再搜
中文、特殊路径、二进制文件导致乱码或无结果？
git grep 本身不处理编码转换，它读的是 Git 对象数据库里的原始 blob 数据。终端编码、Git 配置、文件路径中的非 ASCII 字符，都可能让匹配失败或输出错乱。
- 中文路径/文件名乱码：临时设环境变量
LC_ALL=C再运行命令，或确保终端和git config core.precomposeUnicode一致 - 搜
.png、.pdf等二进制文件：默认跳过，加-a强制按文本解析（结果可能乱码，但能出匹配行） -
-n显示行号却没输出？说明匹配行在未跟踪文件里，不是 bug，是机制使然——加--no-index或先git add - Windows CMD 下引号、反斜杠易出问题，优先用 Git Bash 或 Windows Terminal + WSL
真正难的不是记住参数，而是每次执行前下意识问一句：“这个字符串，Git 当前‘认得’它吗？”——文件是否在索引里、大小写是否对、正则是否逃逸、tree-ish 是否指定准确，四者错一，结果就断崖式归零。
