git log --grep 默认仅匹配提交信息的 subject（首行），不匹配 body、对大小写敏感、不支持正则元字符；搜中文需终端 UTF-8 编码，搜 body 需结合 --pretty 或管道 grep。
git log --grep 能直接搜提交信息，但默认不匹配中文和换行
很多人试了 git log --grep="bugfix" 没反应，其实是默认只搜 commit subject（也就是第一行），而且对大小写敏感、不支持正则元字符。如果关键词在 body 里，或者带空格/中文，就得加参数。
- 加
-i忽略大小写：git log -i --grep="Fix" - 加
--all-match让多个--grep同时生效（比如同时含 “login” 和 “timeout”） - 加
--grep多次可 OR 匹配，但注意：Git 2.39+ 才支持--grep="a" --grep="b"表示 OR；旧版本要用git log | grep -A5 -B1 "keyword"配合管道 - 中文关键词基本能搜，但终端编码要一致（UTF-8），否则可能显示乱码或漏匹配
想搜整个提交内容（包括 message body），得用 --pretty=fuller 或 --format
git log --grep 默认只扫 subject，body 里的描述、Jira ID、测试步骤全被跳过。这不是 bug，是设计如此——Git 把 commit message 分成 subject 和 body，--grep 只看前者。
- 用
git log --pretty="%h %s%n%b" | grep -A1 -B1 "TODO"把完整 message 拼出来再 grep，最稳 - 用
git log --format="%H %s %b" | grep "refactor"更适合脚本处理（%H是完整 hash） - 别用
--oneline配--grep，它会把 body 截掉，搜不到 -
--grep+--full-history不影响 body 搜索范围，只是控制拓扑遍历方式，别混淆
log 输出太长卡住？加 --max-count 或时间范围限制结果数
没限制的 git log --grep 可能扫几千条提交，尤其在主干分支上，终端卡顿、响应慢，甚至误以为命令失败。
- 加
-n 20或--max-count=20先看最近 20 条：git log -n 10 -i --grep="api" - 加时间范围更准：
git log --since="2024-01-01" --until="2024-06-30" --grep="rollback" - 加
--author="name"缩小范围，比纯文本过滤快得多（Git 内部走 reflog 索引） - 别依赖
git log | head -20，因为git log默认分页，head 可能截断不完整 commit
alias 可以简化常用搜索，但注意 shell 层面的引号转义
写 alias 看似方便，但 git config --global alias.greplog 'log -i --grep' 这种写法，遇到带空格的关键词就会崩——比如 git greplog "load timeout"，shell 会把整个字符串当一个参数传给 --grep，而 Git 期望的是 --grep="load timeout" 的形式。
- 安全写法是用 shell 函数：
git config --global alias.greplog '!f() { git log -i --grep="$1" "${@:2}"; }; f' - 这样
git greplog "ci fail" --since="2024-06-01"才能正确拆解参数 - Windows Git Bash 用户要注意：双引号在 cmd/powershell 下行为不同，建议统一用单引号包裹 alias 定义
- alias 里别硬编码
--oneline，它会让--grep失效（原因同上）
真正麻烦的不是语法，是 commit message 本身不规范——比如关键词写在 PR 描述里却没同步进 commit body，或者用 emoji 替代文字（? fix login），这时候 --grep 就完全不可靠。搜不到的时候，先确认人是不是真写进去了。
