版本管理(5)-尽早、经常性的代码合并

merge the code early and often. - by laofo

什么时候做合并

• 一个功能开发完成
• 一个 bug 修复
• 一段代码优化

当你认为我阶段性的完成了一件事（不止做了修改，还需要经过自己认真的验证）且想和大家分享、集成、发布的时候，就可以把自己的代码合并出去了。

合并的原则是什么

• 尽早：尽早的把别人相关的代码合并到自己的工作分支上或者工作空间中来，有利于基于别人最新的代码修改、及时解决冲突、了解项目状态；尽早的把自己的代码合并出去，可以让别人了解自己的修改，周知进度。
• 经常：经常合并，可以让大家不至于基于各自的分支/工作空间走的太远，以至于最后难以合并。
• 整体合并：基于工作内容有一定关联的合并。也就是说把相关的修订版本作为一个修改集合整体合并，有利于代码审查、代码回溯、代码集成、出现问题也容易回滚。

合并注释

每次提交/签入(check-in)代码的注释可以视提交内容填写，但是合并代码的提交注释一定要写清楚。可以关联修复的 bug ID，也可以关联完成的 story，或者直接写注释完成了xxx 和 yyy 都可以。但千万不要写个“代码更新”，此时的注释应充满节操和职业精神。

小结

尽早、经常性地把一组相关的修改合并进来或者合并出去，可以使我们可以在最新的代码基础上进行开发、同时有冲突可以及时得到解决，同步大家的研发进度。整体合并也有利于代码审查、回溯、集成、回滚。