如何在执行合并前识别Git子模块引用的合并冲突？

针对父仓库中两个分支修改同一子模块引用导致的冲突（非子模块内部冲突），可以用以下几种高效方式识别，无需实际执行合并操作：

方法1：用git merge-tree模拟合并（推荐） #

git merge-tree可以在不修改工作区和索引的前提下，模拟合并三个版本（base、分支A、分支B），直接输出合并结果的冲突信息。

步骤： #

1. 先获取两个分支的共同祖先commit：

BASE_COMMIT=$(git merge-base <branch-A> <branch-B>)

2. 执行模拟合并命令：

git merge-tree $BASE_COMMIT <branch-A> <branch-B>

3. 解析输出：
   在输出中，子模块引用冲突会显示类似如下内容：

changed in both: path/to/your/submodule
  <branch-A>: <SHA-A>
  <branch-B>: <SHA-B>

只要出现changed in both且对应子模块的两个SHA值不同，就说明该子模块的引用会产生合并冲突。

方法2：对比分支间子模块的SHA值 #

通过直接对比两个分支及共同祖先中，子模块的引用SHA，判断是否存在双方都修改且值不同的情况。

一行命令快速筛选： #

comm -12 <(git ls-tree -r <branch-A> | grep ^160000 | sort) <(git ls-tree -r <branch-B> | grep ^160000 | sort) | awk '{
    base_sha = $(git rev-parse $(git merge-base <branch-A> <branch-B>):$4)
    if ($1 != base_sha && $4 != base_sha && $1 != $4) print $4
}'

命令解释： #

• git ls-tree -r <branch> | grep ^160000：列出分支下所有子模块（子模块的mode为160000）
• comm -12：筛选出两个分支都存在的子模块
• awk部分：对比子模块在分支A、分支B、共同祖先中的SHA，仅当双方都修改了子模块引用且SHA不同时，输出该子模块路径。

方法3：脚本化解析子模块状态 #

如果需要集成到自动化脚本中，可以通过以下逻辑实现：

1. 获取共同祖先、分支A、分支B的子模块列表及对应SHA
2. 遍历每个子模块路径，判断：
   • 该路径在三个版本中都存在
   • 分支A的SHA ≠ 共同祖先的SHA（分支A修改了引用）
   • 分支B的SHA ≠ 共同祖先的SHA（分支B修改了引用）
   • 分支A的SHA ≠ 分支B的SHA（双方修改的引用不同）
     满足以上条件的子模块，就是会产生引用冲突的对象。

示例bash脚本片段：

BASE=$(git merge-base branch-A branch-B)

# 获取各版本子模块的"路径 SHA"映射
declare -A base_submodules a_submodules b_submodules
while read -r mode sha type path; do
    base_submodules[$path]=$sha
done < <(git ls-tree -r $BASE | grep ^160000)

while read -r mode sha type path; do
    a_submodules[$path]=$sha
done < <(git ls-tree -r branch-A | grep ^160000)

while read -r mode sha type path; do
    b_submodules[$path]=$sha
done < <(git ls-tree -r branch-B | grep ^160000)

# 检查冲突
for path in "${!base_submodules[@]}"; do
    if [[ -n "${a_submodules[$path]}" && -n "${b_submodules[$path]}" ]]; then
        if [[ "${a_submodules[$path]}" != "${base_submodules[$path]}" && "${b_submodules[$path]}" != "${base_submodules[$path]}" && "${a_submodules[$path]}" != "${b_submodules[$path]}" ]]; then
            echo "Conflict detected in submodule: $path"
        fi
    fi
done

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