如何在本地测试仓库重现Git报错：fatal: Need to specify how to reconcile divergent branches.

步骤1：搭建模拟远程仓库 #

# 创建裸仓库作为模拟远程仓库
mkdir remote-repo.git && cd remote-repo.git
git init --bare
cd ..

步骤2：模拟同事创建并推送feature分支 #

# 同事的本地仓库
mkdir colleague-repo && cd colleague-repo
git clone ../remote-repo.git .
git checkout -b feature/test
echo "colleague first commit" > file.txt
git add . && git commit -m "colleague: init feature branch"
git push origin feature/test
cd ..

步骤3：你的本地仓库拉取feature分支 #

# 你的本地仓库
mkdir my-repo && cd my-repo
git clone ../remote-repo.git .
git checkout feature/test
# 此时本地feature/test与远程origin/feature/test提交完全一致

步骤4：同事强制重写远程feature分支历史 #

cd ../colleague-repo
git checkout feature/test
# 撤销之前的提交，重写历史
git reset --hard HEAD~1
echo "colleague rewritten commit" > file.txt
git add . && git commit -m "colleague: rewrite feature history"
# 强制推送覆盖远程分支
git push -f origin feature/test
cd ..

步骤5：你的本地仓库拉取触发目标报错 #

cd my-repo
# 查看分支历史差异：本地保留旧提交，远程已被重写，分支完全分叉
git log --oneline --graph --all

# 尝试常规拉取，触发报错
git pull
# 输出：fatal: Need to specify how to reconcile divergent branches.

步骤6：模拟你当时尝试的无效操作 #

# 尝试--ff-only拉取，因无法快进失败
git pull --ff-only
# 同样触发上述报错

# 尝试重置到本地feature分支（无意义，因为本地分支本身就是旧状态）
git reset --hard feature/test
# 本地分支无任何变化，问题依旧

步骤7：模拟你最终的解决操作 #

# 查看仓库提交记录，找到一个不在feature/test分支上的提交（比如main分支的初始提交）
git log --oneline
# 假设main分支初始提交ID为6c3b91e，执行硬重置
git reset --hard 6c3b91e

# 再次执行快进拉取
git pull --ff-only origin feature/test
# 此时本地feature/test会被快进同步到远程最新状态

错误原因说明 #

本地分支与远程分支的提交历史完全分叉（远程分支历史被强制重写，本地保留的旧提交在远程已不存在），Git默认无法自动处理这种无共同祖先的合并场景，因此抛出该错误。git pull --ff-only要求本地分支必须是远程分支的祖先才能快进，此时不满足条件；而先重置到与远程feature分支有共同祖先的提交（如main分支初始提交）后，本地分支成为远程feature分支的祖先，即可通过快进拉取完成同步。

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