如何通过本地脚本检测GitHub Pull Request是否存在冲突？

核心思路：用git merge-tree模拟合并（无需修改本地代码） #

git merge-tree是Git内置的底层命令，能在完全不改动工作区、索引或分支的前提下，模拟两个分支的合并过程，直接输出冲突相关信息，彻底替代「本地合并-检测冲突-丢弃合并」的低效流程。

具体脚本实现 #

假设你要检测的PR目标分支为main，PR源分支为feature-branch，以下是可直接复用的bash脚本：

#!/bin/bash

# 配置目标分支和PR源分支
TARGET_BRANCH="main"
PR_BRANCH="feature-branch"

# 拉取远程分支最新代码（可选，确保检测基于最新状态）
git fetch origin $TARGET_BRANCH
git fetch origin $PR_BRANCH

# 获取两个分支的最近公共祖先提交
MERGE_BASE=$(git merge-base origin/$TARGET_BRANCH origin/$PR_BRANCH)

# 模拟合并并检测冲突标记
git merge-tree $MERGE_BASE origin/$TARGET_BRANCH origin/$PR_BRANCH | grep -qE "(<<<<<<<|=======|>>>>>>>)"

# 根据检测结果输出提示
if [ $? -eq 0 ]; then
    echo "⚠️ 该PR存在冲突"
    exit 1
else
    echo "✅ 该PR无冲突"
    exit 0
fi

关键步骤说明 #

• git fetch：同步远程分支的最新代码，避免基于本地旧分支版本导致的误判
• git merge-base：定位两个分支的公共祖先，作为模拟合并的基准节点
• git merge-tree：模拟三个提交节点（基准、目标分支、PR分支）的合并，输出中包含<<<<<<</=======/>>>>>>>标记则代表存在冲突
• grep -q：静默过滤冲突标记，通过退出码快速判断是否存在冲突（找到标记则退出码为0，否则为1）

扩展：批量检测PR #

如果需要批量检测仓库内的开放PR，可以结合GitHub API获取PR的分支信息（需安装jq工具解析JSON），再循环执行冲突检测：

# 获取指定仓库的所有开放PR的编号、源分支和目标分支
curl -s "https://api.github.com/repos/你的用户名/你的仓库名/pulls" | jq '.[] | {number: .number, head_ref: .head.ref, base_ref: .base.ref}'

将上述输出的分支信息批量传入冲突检测脚本，即可实现自动化批量检测。

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