git log -S 查找字符串在文件中出现次数发生增减的提交，即新增或删除指定字符串的提交，基于diff语义变化检测，区分大小写、不跨行、不匹配二进制文件。
git log -S 能查到什么
它查的是「某次提交是否新增或删除了指定字符串」，不是模糊匹配提交信息，也不是按文件名筛选。比如你加了一个 class FadeVideo，用 git log -S "class FadeVideo" 就能定位到那次提交；但如果只是在 commit message 里写了 “加了 FadeVideo”，-S 是找不到的。
本质是基于 diff 的语义变化检测：Git 会逐个比对每次提交前后该字符串在文件中出现次数的增减。如果某次提交让这个字符串从 0 变成 1（新增），或从 1 变成 0（删除），就命中。
- 区分大小写，默认开启；加
-i才不区分 - 只作用于被提交修改过的文件，未改动的文件不会被扫描
- 不能跨行匹配；
"class\nFadeVideo"这种换行写法会失败 - 对二进制文件无效，会跳过
常见误用和对应解法
很多人输完 git log -S "xxx" 没结果，第一反应是“没搜到”，其实更可能是参数没配对或理解偏差：
- 忘了加
-i：字符串含大小写混用（如fadevideovsFadeVideo），必须显式加-i - 想查函数定义但写了完整签名：比如
def process_data(self, x: int) -> str:，实际只需搜def process_data，太长容易因空格/类型注解导致不匹配 - 在子目录下执行却没限定路径：默认搜整个仓库，若目标文件在
src/utils/，建议加路径限定git log -S "xxx" src/utils/ - 用了
--grep替代-S：后者搜 commit message，前者才搜代码内容，别混
搭配 -p 和 --oneline 提升效率
单靠 -S 只给提交哈希和基本信息，真正要看改了啥，得立刻接 -p；但输出太长又难扫，所以组合用更实用：
-
git log -i -S "logger.info" --oneline -p：紧凑显示 + 不区分大小写 + 带 diff -
git log -S "TODO" --since="2025-01-01" -n 5：查近一年最多 5 条 TODO 引入记录 -
git log -S "api/v2" --all --oneline：全分支搜索接口路径变更（注意--all否则只当前分支）
注意：-p 会让输出体积陡增，如果只想快速定位，先去掉 -p 筛出哈希，再对特定提交用 git show 查细节更稳。
比 -S 更准的替代方案：git log -G
当 -S 失效——比如你想找「某段逻辑被重构成另一段」，而字符串本身没增删（只是替换了变量名或结构调整），就得换 -G：
-
-G匹配的是 diff 补丁中的正则模式，关注「变化本身是否包含某模式」 - 例如：重构中把
if x > 0:改成if is_positive(x):，-S "x > 0"找不到，但-G "x > 0|is_positive"可以捕获这次修改 - 需要启用正则支持：
git log -E -G "(?i)error.*handler"
真正麻烦的是多层嵌套、宏展开、或模板生成的代码——-S 和 -G 都可能漏掉，这时候得配合 git grep 先定位文件，再用 git log 锁定时间范围手动翻。
