本地分支落后上游远程仓库时提交Pull Request的标准操作流程
针对该开源协作场景的安全操作方案
核心原则
Git分支本质是指向提交对象的可变指针,只要你的代码改动被提交、或被stash暂存,所有切换分支、合并、同步上游的操作都不会物理删除这些改动;所有“丢失代码”的场景,本质是误执行硬重置、强制推送覆盖正确提交导致的,只要规避这两个操作,所有改动都可追溯、可找回。
分步操作流程(覆盖你提到的两种状态)
1. 先保全功能分支的所有现有改动
- 若当前在
gh-150分支上修改完代码,还未执行任何commit:执行git stash push -m "临时暂存gh-150开发改动",操作会把工作区所有未提交的代码完整存入Git暂存栈,工作区回到干净状态,不会改动任何文件内容。 - 若已经在
gh-150分支上完成了首次commit:不需要额外操作,这些提交已经被分支指针绑定,不存在丢失风险。
2. 同步本地master到上游最新状态
这一步操作完全不涉及功能分支的任何数据,和你首次配置上游的操作逻辑一致:
- 切换到本地master分支:
git checkout master - 拉取上游所有最新的分支提交:
git fetch upstream - 快进合并上游master代码到本地:
git merge --ff-only upstream/master使用
--ff-only参数的价值:如果你的本地master没有任何独立开发改动(这也是开源协作应保持的状态——本地master仅用来跟踪上游,不承载任何业务代码),Git会直接把master指针移动到上游最新提交位置,不会产生多余的合并提交;如果本地master有意外的独立提交,Git会直接报错提示,不会偷偷生成分支历史。 - (可选)把同步完成的本地master推送到你自己的GitHub fork仓库:
git push origin master,保证你fork的远端master和上游状态一致。
3. 将上游最新代码同步到功能分支,无丢码风险
这一步就是你担心“相同代码被修改会丢失本地更新”的环节,按标准流程操作根本不会出现丢码问题:
- 切回
gh-150功能分支:git checkout gh-150 - 如果之前用stash暂存了未提交的改动:执行
git stash pop把暂存的代码完整恢复到工作区,确认所有开发内容无缺失再继续。 - 将已同步最新代码的本地master合并到功能分支:
git merge master合并出现冲突是正常现象,Git的三方合并机制会自动整合两边的改动,只有当同一行代码被双方同时修改时,才会标记为冲突点要求你手动确认——所有你写的本地代码都会完整呈现在冲突标记块中,需要你主动选择保留哪些内容,不会被自动覆盖。只要你不主动选择用上游版本替换本地代码,你的改动就不会丢失。
- 解决完所有冲突后,执行
git add .标记冲突已处理,再执行git commit完成合并操作。
4. 提交Pull Request
等功能分支同步完上游最新代码、所有本地改动完整保留、无未解决的冲突,就可以将功能分支推送到你自己的fork仓库:git push origin gh-150,之后在GitHub上选择该分支向上游仓库发起PR即可。
长期协作的最佳实践习惯
- 永远保持本地master分支和上游master完全同步,不要在master分支上写任何业务代码,所有开发工作都在从master切出的独立功能分支上开展。
- 每次启动新功能开发前,先把本地master同步到上游最新状态,再从最新的master切功能分支,从根源减少后续合并的冲突量。
- 如果你偏好更干净的提交历史,可以在功能分支同步上游代码时,将
git merge master替换为git rebase master:这个操作会把你在功能分支上的所有提交,逐个“摘下”后接到最新master的提交后面,遇到冲突逐个解决即可,最终提交历史不会保留多余的合并节点,也同样不会丢失你的本地代码。 - 遇到任何分支操作失误,都可以通过
git reflog查看本地所有的提交指针变动记录,找回被误操作覆盖的改动,不存在“一操作就把所有代码弄没”的情况。
内容的提问来源于stack exchange,提问作者Manuel Jordan
相关产品推荐
相关产品推荐

