如何修改多次提交信息（交互式变基）？

要解决这个问题，Git 的交互式变基（Interactive Rebase）是一个理想的工具。它能帮助你在推送代码前，安全、高效地整理本地的提交历史，让你的每一次贡献都显得清晰而专业。

什么是交互式变基？

交互式变基是 git rebase 命令的一个特殊模式，通过添加 -i 或 --interactive 参数来启用。你可以将它理解为一个“提交历史编辑器”。

执行 git rebase -i 命令后，Git 会在你的默认文本编辑器中打开一个列表，其中包含了你指定范围内的所有 commit。在这个列表中，你可以通过修改指令来重新排序、合并、修改，甚至删除这些 commit，从而重塑你的提交历史。

开始前的安全检查清单

在进行任何可能改写历史的操作前，建立安全意识至关重要。请在执行交互式变基前，快速检查以下几点：

• 确认分支是纯本地的：这是最核心的原则。绝对不要在一个已经被推送到公共仓库、且有多人协作的分支上执行变基。这会重写公共历史，给其他协作者带来巨大的麻烦。
• 确认没有未提交的更改：运行 git status 确保你的工作目录是干净的（没有未提交的修改或未暂存的文件），这可以避免变基过程中出现不必要的复杂情况。
• 知道如何“反悔”：变基过程中如果遇到问题或不确定如何继续，你可以随时中止操作。最常用的命令是 git rebase --abort，它会让你的分支恢复到变基开始前的状态。

核心操作：合并与修改提交

对于大多数日常整理工作而言，我们只需要掌握交互式变基中的两个核心指令：squash 和 reword。它们能解决大约 80% 的需求。

要开始操作，你需要告诉 Git 你想整理从哪个 commit 开始的历史。最常用的方式是指定最近的 N 个 commit，命令格式如下：

git rebase -i HEAD~N

这里的 N 代表你想要回顾的 commit 数量。例如，HEAD~3 表示整理最近的 3 个 commit。执行后，编辑器会打开一个类似下面的文件：

pick a1b2c3d feat: add user login form
pick e4f5g6h fix: correct input validation
pick i7j8k9l style: adjust button margin
# Rebase ...
#
# Commands:
# p, pick <commit> = use commit
# r, reword <commit> = use commit, but edit the commit message
# s, squash <commit> = use commit, but meld into previous commit
# ... (other commands)

每一行代表一个 commit，格式为 指令 commit哈希值 提交信息。默认指令是 pick，表示“按原样使用这个 commit”。接下来，我们只需要修改这些指令即可。

使用 squash 合并多个提交

squash（或简写为 s）指令用于将一个 commit 合并到它的前一个 commit 中。这非常适合将多个零散的修复或过程性提交整合成一个有意义的功能提交。

假设我们的目标是将后两个修复性的 commit 合并到第一个功能性 commit 中。

1. 启动交互式变基。比如我们要整理最近 3 个 commit：

   git rebase -i HEAD~3

2. 修改指令。在打开的编辑器中，保留第一个 commit 为 pick，将其余希望被合并的 commit 的指令修改为 squash 或 s。

   pick a1b2c3d feat: add user login form
   s e4f5g6h fix: correct input validation
   s i7j8k9l style: adjust button margin

   这个配置的含义是：将 e4f5g6h 合并到 a1b2c3d，然后将 i7j8k9l 合并到前面新生成的结果中。

3. 保存并关闭编辑器。

4. 撰写新的提交信息。Git 会自动打开第二个编辑器窗口，里面包含了所有被合并 commit 的信息。你需要在这里删除旧的、零散的信息，为这个全新的、合并后的 commit 撰写一条清晰、完整的提交信息。

   # This is a combination of 3 commits.
   # This is the 1st commit message:
   feat: add user login form
   # This is the 2nd commit message:
   fix: correct input validation
   # This is the 3rd commit message:
   style: adjust button margin

   将上述内容修改为：

   feat: implement user login feature
   - Add the basic HTML structure for the login form.
   - Implement client-side input validation for email and password.
   - Adjust UI styles for better alignment and user experience.

5. 再次保存并关闭编辑器。变基完成。现在，你本地的 3 个零散 commit 已经变成了一个清晰、完整的 commit。

使用 reword 修改提交信息

reword（或简写为 r）指令专门用于修改某个 commit 的提交信息，而不会触及其代码内容。当你发现之前的 commit message 有拼写错误，或者描述不够准确时，这个指令非常有用。

1. 启动交互式变基。指定包含你想修改的 commit 的范围。

   git rebase -i HEAD~3

2. 修改指令。找到你想要修改信息的那一行，将 pick 改为 reword 或 r。

   pick a1b2c3d feat: add user login form
   r e4f5g6h fix: corect input validation  # <-- 假设这里有拼写错误
   pick i7j8k9l style: adjust button margin

3. 保存并关闭编辑器。

4. 修改提交信息。Git 会立刻打开一个新的编辑器窗口，里面只包含你标记为 reword 的那个 commit 的信息。直接修改它。

   fix: correct input validation

5. 保存并关闭编辑器。操作完成，该 commit 的信息已被更新。

了解更多 rebase 指令

除了 squash 和 reword，交互式变基还提供了一些其他有用的指令，虽然使用频率较低，但在特定场景下非常高效。

• edit (或 e) 当你想对某个旧 commit 进行不止修改信息的操作时（比如补充一些代码修改），可以使用 edit。变基过程会停在该 commit 之后，给你一个机会使用 git commit --amend 来修改代码和信息，修改完成后用 git rebase --continue 继续变基。

• fixup (或 f) fixup 的作用与 squash 非常相似，都是将当前 commit 合并到前一个 commit。唯一的区别是，fixup 会直接丢弃当前 commit 的信息，不会在后续让你编辑。这对于合并那些信息完全无用（如 “fix typo”、“oops”）的 commit 来说，是 squash 的一个快捷方式。

交互式变基的风险与中止操作

交互式变基非常强大，但它的核心是“重写”历史。因此，必须牢记它的安全边界。

最重要的规则是： 不要在任何已推送到公共仓库、且有他人正在使用的分支上执行变基操作。

因为变基会创建全新的 commit 来替换旧的 commit（即使内容完全一样，commit 哈希值也会改变），如果你将重写后的历史强制推送到公共分支，会与协作者本地的历史产生严重分歧，导致他们的后续工作陷入混乱。

如果在变基过程中遇到冲突（conflict），Git 会暂停并提示你解决。对于初学者来说，处理冲突可能有些棘手。此时，最安全的选择是中止变基，让一切恢复原样。只需执行以下命令：

git rebase --abort

这个命令会清理所有变基过程中的临时文件，让你的分支回到执行 git rebase -i 之前的状态，可以放心使用。

总结：形成专业的提交习惯

将交互式变基作为发起合并请求前的例行步骤，是一种非常专业且值得提倡的开发习惯。它不仅能让你的个人贡献在版本历史中显得井井有条，更能极大地方便团队成员进行代码审查（Code Review）。

不必追求一次性掌握所有指令，熟练运用 squash 和 reword 就足以应对绝大多数场景。在高效的研发流程中，我们鼓励团队成员使用交互式变基来确保提交历史的清晰性，这极大地提升了代码审查的效率。从今天起，不妨在你的下一个功能分支上尝试一下这个强大的工具。