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，是因为点号 . 被当成了正则通配符。

Git Changelog Generator

使用约定式提交（Conventional Commits）从 Git 历史记录中生成结构化变更日志，支持多种格式、AI 增强型描述以及可自定义的范围……

下载

• 忽略大小写：固定加 -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 是否指定准确，四者错一，结果就断崖式归零。