git grep 命令

git grep 命令用于在 Git 仓库的文件内容中搜索指定的字符串或正则表达式。它类似于 Linux 下的 grep 命令，但更适合在版本库中查找代码，支持搜索当前工作区、暂存区或者特定提交中的内容。

git grep 能帮助你快速定位代码中的某个关键词、函数调用或变量定义，特别适合大项目或多人协作时快速定位代码相关信息。

命令语法

git grep [选项] <搜索模式> [--] [<路径>...]

常用选项参数

• -i：忽略大小写进行搜索。
• -n：显示匹配行的行号。
• -w：匹配整个单词，而不是部分匹配。
• -v：反向匹配，显示不包含搜索模式的行。
• --count：只显示匹配行的数量。
• --heading：在输出结果中显示文件名作为标题。
• --break：不同文件之间插入空行。
• --files-with-matches：只列出包含匹配内容的文件名。
• --all-match：搜索多个模式时，文件必须匹配所有模式才显示。
• -e <模式>：指定多个匹配模式。

使用示例

在当前工作区所有文件中查找字符串 TODO：

git grep TODO

忽略大小写查找 fixbug：

git grep -i fixbug

显示匹配的行号，查找 function：

git grep -n function

只列出包含 config 的文件名：

git grep --files-with-matches config

在 src/ 目录下查找 error：

git grep error -- src/

反向查找不包含 debug 的行：

git grep -v debug

同时搜索多个模式 TODO 和 FIXME（匹配包含任一模式的行）：

git grep -e TODO -e FIXME

小贴士

• git grep 默认只搜索当前工作区中的文件内容，不会搜索 Git 之外的文件。

• 你也可以指定搜索特定提交、分支或标签的内容，例如：

  git grep TODO main

  这样会在 main 分支的最新提交中查找 TODO。

• 配合 xargs 命令，可以对搜索结果批量执行操作，提高效率。