如何将本地Git主线变更合并到上游主线并保留提交历史？

操作步骤 #

• 拉取上游最新代码但不自动合并：git fetch upstream
• 切换到你的本地工作分支（比如main）：git checkout main
• 执行带--no-ff参数的合并，强制生成合并提交并自定义有意义的提交信息：

  git merge --no-ff upstream/main -m "Merge upstream commit u1 into local branch
  - 上游变更：[简要描述u1内容，例如修复XX兼容性问题]
  - 本地保留变更：d1（调整核心模块打印语句）、d2（同步更新对应测试用例）"
  

方案优势 #

• 完整保留历史：--no-ff参数会强制创建新的合并提交，保留本地分支与上游分支的分叉节点，不会像rebase那样改写提交链、丢失分支合并轨迹，完全满足回归问题排查的信息需求。
• 避免foxtrot merge：合并提交会明确标记上游分支的贡献，不会让本地分支错误成为主线历史的主导分支。
• 回滚与追溯更便捷：清晰的自定义提交信息能快速说明合并背景，后续若需回滚，直接执行git revert <合并提交ID>即可，不会混淆本地与上游的变更边界。

额外实用技巧 #

• 若需要更细致的合并记录，可省略-m参数直接执行git merge --no-ff upstream/main，Git会自动打开编辑器，允许你补充上游提交哈希、本地提交哈希等细节，进一步提升历史追溯性。
• 合并前可用git log --oneline --graph upstream/main..main查看本地与上游的分叉历史，确认所有本地变更已被正确追踪后再执行合并。

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