Git 报 "refusing to merge unrelated histories" 怎么办
该错误表示两个分支没有共同祖先（各自独立初始化）。确认确实要合并后加 --allow-unrelated-histories：git pull origin main --allow-unrelated-histories 或 git merge <分支> --allow-unrelated-histories，然后解决冲突提交。
这个错误说明你要合并的两段历史没有共同祖先——典型场景：GitHub 建仓库时勾了 README 自动初始化，本地也 git init 提交了代码，两边是各自独立的历史。确认合并是意图后，加 --allow-unrelated-histories 参数强制执行即可。
解决方法
# 场景一：本地仓库第一次关联 GitHub 空仓库（有 README）
git remote add origin git@github.com:user/repo.git
git pull origin main --allow-unrelated-histories
# 解决可能的冲突（比如两边都有 README.md）后提交
git push -u origin main
# 场景二：合并两个独立项目
git merge other-branch --allow-unrelated-histories
更干净的替代方案
如果一边只是"占坑"的初始 README，比起强行缝合两段历史，更好的做法是：
# 放弃本地历史，以远程为准重新放代码
git clone <远程地址> fresh-repo
cp -r 你的代码 fresh-repo/
cd fresh-repo && git add -A && git commit && git push
或者反过来：本地历史为主，直接 git push -f origin main 覆盖远程的 README 提交（确认远程没有别人工作成果时）。
常见问题（FAQ）
Q：怎么判断是不是真的"无关历史"？
git log --oneline --graph --all 看两条线是否有交汇点；或 git merge-base main other-branch 无输出即无共同祖先。
Q：加了这个参数会有什么副作用？
两段历史被缝合，根提交变成两个，log 图会出现"双起源"。功能上无碍，但如果是误操作（比如远程地址配错），缝合后清理麻烦——执行前务必确认远程仓库地址正确。
Q：rebase 也报这个错怎么办？
同样加参数：git rebase main --allow-unrelated-histories。但对无关历史做 rebase 冲突通常更多，merge 更省心。
