多人编辑CHANGELOG.md出现合并冲突 如何通过Git/GitHub设置适配合并策略

你提到的多人同时修改Changelog导致冲突的场景非常普遍，绝大多数开发团队都会遇到同类问题，Git本身就支持为单个文件指定专属合并策略，完全可以适配你的需求。

方案1：使用union合并策略（最快生效，适配现有工作流） #

Git内置的union合并策略专门用于所有人只新增内容、不修改历史内容的文件，Changelog刚好是典型的适用场景。配置步骤如下：

1. 在项目根目录创建名为.gitattributes的文件
2. 在文件中添加如下配置：

CHANGELOG.md merge=union

3. 将.gitattributes文件提交到仓库主分支即可，所有团队成员拉取最新代码后配置自动生效，无需单独修改本地Git设置。

union合并策略的逻辑是：当两个分支都对该文件有新增内容时，Git会直接保留两边的所有新增内容，不会触发合并冲突，完全适配你们团队完成功能后在Changelog顶部新增一行的工作流。

注意事项 #

• 只有在团队成员都只会新增Changelog条目、不会修改/删除已提交的历史条目的场景下可以完全规避冲突，你们当前的使用场景完全符合要求
• 如果后续有修改历史Changelog内容的需求，还是可能出现少量冲突，属于正常情况

方案2：变更片段式管理（完全杜绝冲突，适合中大型团队） #

如果想要彻底避免Changelog相关的合并冲突，可以调整工作流，采用业内常见的变更片段管理方案：

• 在项目中新增专门的目录（比如.changesets）用于存储未正式发布的变更条目
• 开发人员完成功能后，不需要修改主CHANGELOG.md，只需要在该目录下新增一个独立的md文件，写入自己的变更说明即可，文件名可以用「功能标识+时间戳/PR编号」的格式，完全不会出现多人修改同一文件的情况
• 正式发版时，通过脚本或者开源工具自动将目录下的所有变更条目汇总到主CHANGELOG.md的顶部，清空该目录即可

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