如何在Git提交历史中定位使用Git Flow的Swift项目引入的Bug

1. 二分查找定位（最高效的通用方案） #

使用Git自带的git bisect工具通过二分法快速缩小提交范围，步骤如下：

• 先确认两个基准提交：当前存在Bug的提交（通常为HEAD）、确定不存在该Bug的历史提交（Git Flow工作流中可直接取master分支上的历史发布tag作为基准）
• 启动二分查找流程：

  git bisect start
  

• 标记当前版本为坏提交：

  git bisect bad
  

• 标记无Bug的基准版本为好提交，例如基准为v1.1.0的tag时：

  git bisect good v1.1.0
  

• 后续Git会自动切换到两次提交的中间版本，你只需编译验证当前版本是否存在Bug：存在就执行git bisect bad，不存在就执行git bisect good，重复操作3-7次即可定位到第一个引入Bug的提交。
• 定位完成后执行git bisect reset即可回到启动查找前的分支状态。

2. 代码行追溯 #

如果你已经定位到Bug出现在具体的某几行代码上，可直接用git blame追溯改动来源：

• 查看单文件每一行的最后修改记录：

  git blame 目标文件路径
  

• 如果文件存在重命名历史，添加-M参数跟踪重命名前的改动：

  git blame -M 目标文件路径
  

3. 提交历史检索 #

如果你大概知道Bug关联的功能关键词、代码片段，可通过git log过滤提交：

• 按提交信息关键词检索：

  git log --grep="关联功能关键词"
  

• 按具体代码片段检索，查找所有修改过这段代码的提交：

  git log -S "关联代码片段"
  

• 限定只检索涉及指定文件的提交，缩小排查范围：

  git log -- 文件路径1 文件路径2
  

• 优先用master分支的正式发布tag作为无Bug基准，不要用未合入稳定版本的feature、develop分支提交作为基准，避免其他未完成改动干扰判断。
• 如果确认Bug是当前迭代的develop分支新引入的，可直接在develop分支的提交范围内执行上述操作，无需牵扯历史稳定版本。

• Git原生工具：上述提到的git bisect、git blame、git log已覆盖绝大多数检索场景，无需额外安装。
• Xcode集成工具：Xcode自带Git历史查看、Blame功能，打开源代码导航器选择「历史」即可查看单文件所有改动，代码行右侧可直接显示对应提交信息，无需执行命令。
• 终端可视化工具tig：轻量级Git文本界面工具，支持可视化浏览提交历史、搜索提交信息和代码改动，操作比原生Git命令更便捷，可直接通过brew安装。

内容的提问来源于stack exchange，提问作者Negar