如何合并存在文件差异的本地与GitHub远程Git仓库

这种本地与GitHub网页端修改形成的提交分叉，本质是两边各自产生了独立的提交、没有共同的同步节点，Git默认会拦截直接pull/push的操作，按照下面的步骤操作可以完整保留两边的改动，恢复正常的同步链路： #

前置准备操作（必做，避免改动丢失） #

• 先把本地所有未提交的临时改动暂存备份：git stash push -m "本地待合并改动临时备份"
• 拉取远程仓库全量提交到本地缓存，不做自动合并：git fetch origin

方案一：保留整洁提交历史的合并方式 #

适合对Git提交记录有整洁度要求的场景，操作后远程历史不会多出无意义的合并节点：

1. 执行变基操作，把本地的独立提交迁移到远程最新提交的后面，Git会自动识别两边的内容差异并标记冲突文件：
   git rebase origin/<你的当前分支名，比如main>
2. 打开Git提示的所有冲突文件，逐处判断需要保留的内容：可以选择保留本地原有内容、保留GitHub网页的修改内容，或者将两边内容拼接整合
3. 所有冲突标记清理完成后，取出之前暂存的本地临时改动：git stash pop
4. 全局检查文件内容确认无问题后，正常提交所有合并内容，直接执行git push origin <你的当前分支名>即可恢复正常推送。

方案二：低学习成本的快速合并方式 #

适合对提交历史整洁度没有要求、不想处理复杂变基逻辑的场景：

1. 直接执行允许不相关历史合并的合并命令，强制触发Git的三方差异识别逻辑：
   git merge origin/<你的当前分支名> --allow-unrelated-histories
2. 按照Git提示逐文件处理冲突点，无冲突的内容Git会自动完成两边拼接，不会覆盖任意一侧的原有改动
3. 确认内容无误后直接提交，即可正常推送到远程仓库。

高风险误操作提醒 #

以下操作会直接导致改动丢失，非必要不要执行：

• 不要直接使用git push -f强制推送，该操作会直接覆盖GitHub远程的所有内容，网页端的修改会全部丢失
• 不要直接删除本地仓库重新克隆远程内容，本地未推送的所有改动会无法找回
• 没有确认备份的前提下，不要执行git reset --hard类的强制重置命令，会直接清空本地工作区的修改

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