git grep
命名
git-grep - 打印符合模式的行
概要
git grep [-a | --text] [-I] [--textconv] [-i | --ignore-case] [-w | --word-regexp] [-v | --invert-match] [-h|-H] [--full-name] [-E | --extended-regexp] [-G | --basic-regexp] [-P | --perl-regexp] [-F | --fixed-strings] [-n | --line-number] [-l | --files-with-matches] [-L | --files-without-match] [(-O | --open-files-in-pager) [<pager>]] [-z | --null] [-c | --count] [--all-match] [-q | --quiet] [--max-depth <depth>] [--color[=<when>] | --no-color] [--break] [--heading] [-p | --show-function] [-A <post-context>] [-B <pre-context>] [-C <context>] [-W | --function-context] [--threads <num>] [-f <file>] [-e] <pattern> [--and|--or|--not|(|)|-e <pattern>…] [--recurse-submodules] [--parent-basename <basename>] [ [--[no-]exclude-standard] [--cached | --no-index | --untracked] | <tree>…] [--] [<pathspec>…]
描述
在工作树中跟踪文件中查找指定的模式，在索引文件中注册的斑点或给定树对象中的斑点。模式是由换行符分隔的一个或多个搜索表达式的列表。作为搜索表达式的空字符串与所有行匹配。
组态
grep.lineNumber
如果设置为 true ，则-n默认启用选项。
grep.patternType
设置默认的匹配行为。使用值basic，extended，fixed，或perl将启用--basic-regexp，--extended-regexp，--fixed-strings，或--perl-regexp相应的选项，而值default将返回到默认匹配行为。
grep.extendedRegexp
如果设置为 true，则--extended-regexp默认启用选项。当该grep.patternType选项设置为非时，该选项将被忽略default。
grep.threads
要使用的 grep 工作线程数。如果未设置（或设置为0），则默认使用8个线程（现在）。
grep.fullName
如果设置为 true ，则--full-name默认启用选项。
grep.fallbackToNoIndex
如果设置为 true ，则回退到 git grep --no-index，如果 git grep 在 git 存储库之外执行。默认为 false 。
选项
--cached
搜索工作树中的追踪文件，而不是搜索索引文件中注册的斑点。
--no-index
搜索当前目录中不受 Git 管理的文件。
--untracked
除了在工作树中跟踪文件中搜索外，还可以在未跟踪文件中搜索。
--no-exclude-standard
通过不尊重.gitignore机制来搜索被忽略的文件。只用于--untracked。
--exclude-standard
不要关注通过.gitignore机制指定的忽略文件。仅在使用当前目录搜索文件时有用--no-index。
--recurse-submodules
递归搜索已在存储库中初始化并检出的每个子模块。当与 <tree> 选项结合使用时，所有子模块输出的前缀将是父项目的 <tree> 对象的名称。
--parent-basename <basename>
仅限内部使用。为了使用 --recurse-submodules 选项产生统一的输出，可以使用此选项将父级的 <tree> 对象的基名称提供给子模块，以便子模块可以将其输出与父级名称相加，而不是使用 SHA1 子模块。
-a --text
像处理文本一样处理二进制文件。
--textconv
尊重 textconv 过滤器设置。
--no-textconv
不要兑现 textconv 过滤器设置。这是默认设置。
-i --ignore-case
忽略模式和文件之间的大小写区别。
-I
不匹配二进制文件中的模式。
--max-depth <depth>
对于命令行中给出的每个 <pathspec> ，最多下降 <depth> 级别的目录。负值意味着没有限制。如果 <pathspec> 包含活动通配符，则忽略此选项。换句话说，如果 “a *” 匹配名为 “a *” 的目录，则“*”的字面匹配如此 - max-depth 仍然有效。
-w --word-regexp
仅在字边界处匹配模式（或者从一行的开始处开始，或者以非单词字符开头;结束于一行的末尾或后面跟着一个非单词字符）。
-v --invert-match
选择不匹配的行。
-h -H
默认情况下，该命令显示每个匹配的文件名。-h选项用于抑制此输出。-H是否有完整性，除了-h在命令行中早先给出的覆盖之外，不会执行任何操作。
--full-name
从子目录运行时，该命令通常会输出相对于当前目录的路径。该选项强制相对于项目顶部目录输出路径。
-E --extended-regexp -G --basic-regexp
对于模式使用 POSIX 扩展/基本正则表达式。默认是使用基本的正则表达式。
-P --perl-regexp
为模式使用 Perl 兼容的正则表达式。
对这些类型的正则表达式的支持是可选的编译时间依赖性。如果 Git 没有编译支持它们，提供这个选项会导致它失效。
-F --fixed-strings
使用固定字符串模式（不要将模式解释为正则表达式）。
-n --line-number
在行号前加上匹配的行。
-l --files-with-matches --name-only -L --files-without-match
不显示每条匹配的行，只显示包含（或不包含）匹配的文件的名称。为了更好的兼容性git diff，--name-only是一个同义词--files-with-matches。
-O<pager> --open-files-in-pager=<pager>
打开寻呼机中的匹配文件（不是输出grep）。如果寻呼机恰好是 “较少” 或 “vi” ，并且用户只指定一个模式，则第一个文件将自动定位在第一个匹配位置。该pager论点是可选的; 如果指定，它必须粘贴到选项没有空格。如果pager未指定，将使用默认寻呼机（请参阅core.pager git-config [1] ）。
-z --null
输出 \ 0 而不是通常跟在文件名后的字符。
-c --count
显示匹配的行数，而不是显示每条匹配的行。
--color=<when>
显示结果为彩色。该值必须 always（默认），never 或 auto 。
--no-color
关闭匹配突出显示，即使配置文件将默认设置为彩色输出。和--color=never一样。
--break
在不同文件的匹配之间打印空行。
--heading
在文件的上方显示文件名，而不是在每个显示的行的开头。
-p --show-function
显示包含匹配函数名称的上一行，除非匹配行是函数名称本身。该名称的确定方式与git diff制作补丁大小标头的方式相同（请参阅Defining a custom hunk-header gitattributes [5]）。
-<num> -C <num> --context <num>
显示 <num> 前导和尾部线条，并放置包含--连续的匹配组之间的线条。
-A <num> --after-context <num>
显示 <num> 尾随线，并--在连续的匹配组之间放置一行。
-B <num> --before-context <num>
显示 <num> 引出线，并--在相邻的匹配组之间放置一行。
-W --function-context
显示前一行中包含函数名称的周围文本，直到下一个函数名称之前的文本，从而有效地显示找到匹配的整个函数。
--threads <num>
要使用的 grep 工作线程数。参见grep.threads以CONFIGURATION获取更多信息。
-f <file>
从 <file> 中读取模式，每行一个。
-e
下一个参数是模式。这个选项必须用于模式的开头，-并且应该在将用户输入传递给 grep 的脚本中使用。多个模式组合在一起or。
--and --or --not ( … )
指定如何使用布尔表达式组合多个模式。--or是默认的运营商。--and比--or优先。-e必须用于所有模式。
--all-match
将多个模式表达式结合使用时--or，会指定此标志以将匹配限制为具有与其匹配的所有行的文件。
-q --quiet
不要输出匹配的行; 取而代之的是，当状态0出现匹配时退出，当不存在时退出非零状态。
<tree>…
而不是在工作树中搜索跟踪文件，搜索给定树中的斑点。
--
表示选项结束; 其余的参数是 <pathspec> 限制器。
<pathspec>…
如果给定，则将搜索限制为至少匹配一个模式的路径。两个前导路径匹配并支持 glob（7）模式。
有关 <pathspec> 语法的更多详细信息，请参阅pathspec gitglossary [7]中的条目。
例子
git grep 'time_t' -- '*.[ch]'
查找time_t在所有跟踪的 .c 和 .h 文件在工作目录及其子目录。
git grep -e '#define' --and \( -e MAX_PATH -e PATH_MAX \)
查找具有#define的线，要么是MAX_PATH或PATH_MAX。
git grep --all-match -e NODE -e Unexpected
查找具有NODE或Unexpected两者匹配的行的文件。
git grep solution -- :^Documentation
寻找solution，不包括Documentation中的文件。