Git Hook处理Maven POM文件合并冲突的方案问询

核心问题的精细化自动解决 #

直接用git checkout --theirs会丢失开发者的自定义修改（比如新增依赖），推荐用Git自定义合并驱动针对POM文件做精细化处理：只保留主分支的版本号，其余内容（依赖、插件配置等）保留开发者分支的修改。

配置步骤 #

1. 在仓库根目录创建/修改.gitattributes文件，添加规则：

   **/pom.xml merge=pom-version-merge
   

   这个规则会让所有模块的pom.xml使用自定义的合并驱动。

2. 在仓库的.git/config（或全局~/.gitconfig）中定义合并驱动：

   [merge "pom-version-merge"]
     name = Keep main branch version, preserve local customizations
     driver = awk '/<version>/{getline < "MERGE_HEAD"; print} !/<version>/' %A %B %O > %A.tmp && mv %A.tmp %A
   

   脚本逻辑：遇到<version>节点时，读取主分支（MERGE_HEAD）的版本号替换；其他行直接保留当前分支的内容，完美兼顾版本号同步和自定义修改保留。

配合Git Hook的版本验证 #

不管是自动合并还是手动解决冲突，用pre-commit Hook做最终验证：

• 调用你已有的版本验证脚本，检查POM版本是否符合分支规则（开发分支需为Major.Minor.Patch.Build-DEV-QUALIFIER-SNAPSHOT格式）。
• 如果版本不符合，Hook可自动调用Maven的versions:set命令调整版本，或者直接提示开发者手动修正。

合并与变基场景的覆盖 #

• post-rewrite Hook主要针对变基、提交修改（amend）这类重写历史的操作，无法覆盖所有合并场景（比如非快进合并生成新commit时不会触发）。
• 建议组合使用：用自定义合并驱动处理合并时的冲突，用post-rewrite Hook在变基完成后触发版本验证/调整，确保两种场景都能正确处理版本号。

现成工具与备选方案 #

• Maven插件辅助：用versions-maven-plugin可以批量设置版本，配合Hook在合并/变基后自动调整版本格式，无需额外第三方库。
• 手动解决+Hook验证：如果不想配置合并驱动，可要求开发者手动解决冲突——保留自身的依赖修改，将版本号替换为主分支最新版本。然后用pre-commit Hook验证版本格式，不符合则阻止提交并给出明确提示。
• 不建议直接清理冲突标记保留主分支版本：这种操作会丢失所有自定义修改，仅适用于冲突仅存在于版本号的极端场景，风险极高。

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