- 已经会基本提交和分支操作的开发者
- 想理解命令边界与风险的人
Command Reference
git-grep 教程
解释如何用 git-grep 在仓库内容中搜索文本。
- 知道工作区、暂存区、提交的基本关系
- 能读懂 `git status` 和简单历史图
- 误把本地整理命令用到共享历史
- 在没确认恢复路径前直接继续改写历史
一句话理解
git-grep 用于在仓库内容中搜索文本。
什么时候适合用
- 当你需要在仓库内容中搜索文本
- 当你想把这类操作做成稳定流程而不是手工重复
- 当你需要更准确地理解 Git 在这一步到底记录了什么
基本示例
git grep "TODO"
读这条命令时最该注意什么
先把默认行为弄清楚，再去组合更多参数，通常能少踩很多隐藏规则。
一个更稳的实践建议
把它和 status、log、diff 一起看，更容易确认到底改了什么。
补充理解角度
- 理解这条命令的默认行为
- 把它放进日常提交或排查流程
- 在脚本或团队习惯里稳定复用
这条命令在流程里解决什么问题
git grep 在仓库的已跟踪文件中搜索匹配的文本模式，默认忽略未跟踪文件和 .gitignore 的内容。理解它时，要把它放在"如何在代码库中快速定位特定内容"这个场景中来看。
典型用例
- 在代码库中快速查找某个函数、变量或常量的所有引用位置。
- 配合
--cached搜索暂存区内容，或指定特定提交/分支来搜索历史版本。 - 用
-n（行号）、-i（忽略大小写）、-c（计数）等选项定制搜索结果。
图例理解
搜索模式目标范围（工作区/暂存区/特定提交）
匹配行及文件位置
git grep 只搜索已跟踪文件，结果不会混入构建产物或临时文件。
特殊情况与边界
git grep默认只搜索已跟踪文件，.gitignore 中的文件不会被搜索到。- 可以使用
--and、--or、--not组合多个搜索模式，实现更精确的匹配。 - 搜索范围可以通过指定提交、树对象或路径来限制，比如
git grep "TODO" v1.0 -- src/。 - 在大型仓库中，git grep 通常比系统 grep 更快，因为 Git 只遍历索引中的文件而不是扫描整个文件系统。
延伸阅读
继续搭配 git status、git log、git show 一起看，通常更容易判断这条命令对历史、索引和工作区分别造成了什么影响。