子模块中使用.gitattributes合并策略失效的问题咨询

我来帮你搞定这个子模块合并的痛点——你遇到的merge=ours不生效的情况其实挺常见，核心原因是Git对子模块的处理逻辑和普通文件有差异，咱们一步步拆解：

为什么.gitattributes的merge=ours没生效？ #

merge=ours这个配置本身是正确的，但它只作用于子模块的引用哈希值合并：当两个分支的子模块指向不同commit时，Git会把这个子模块标记为冲突，这时候merge=ours才会自动用当前分支的版本来解决冲突。但如果你的合并失败是因为子模块工作树不干净（有未提交修改）、或者Git检测到子模块的状态异常，这个配置就派不上用场了——因为Git会先检查子模块状态，再处理合并逻辑。

可行的解决方案 #

1. 合并时直接指定子模块专属合并策略 #

执行合并命令时，加上-Xsubmodule=ours参数，这是Git专门为子模块设计的合并策略，能强制用当前分支的子模块版本覆盖目标分支的版本，自动解决引用冲突：

git merge -Xsubmodule=ours <你的目标分支名>

这个方法最直接，适合单次合并操作。

2. 全局/仓库级配置默认子模块合并策略 #

如果你不想每次合并都手动加参数，可以配置全局或当前仓库的默认子模块合并策略：

• 全局配置（所有仓库生效）：

  git config --global submodule.merge ours
  

• 当前仓库单独配置：

  git config submodule.merge ours
  

这个配置和.gitattributes的merge=ours配合使用，能让子模块合并的规则更稳定。

3. 变基时忽略子模块变更 #

如果是变基操作，上面的合并策略配置可能不生效，这时候可以用--ignore-submodules参数彻底忽略子模块的状态：

git rebase --ignore-submodules=all <你的目标分支名>

--ignore-submodules=all会让Git在变基过程中完全无视子模块的任何变更（不管是工作树还是索引的修改），避免子模块状态干扰变基。

额外注意事项 #

• 先确保子模块工作树干净：如果子模块里有未提交的修改，Git在合并/变基时会直接报错，这时候任何合并策略都没用，先提交或stash子模块的修改再操作。
• 检查.gitattributes的正确性：确保你的规则写法正确，路径和子模块目录名完全一致，并且这个文件已经提交到主仓库：

  internal merge=ours
  

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