如何在不丢失目标分支历史记录的前提下用一个分支覆盖另一个分支

你可以根据团队的历史追溯需求选择以下两种方案，两种都不会丢失旧分支的历史记录：

方案1：打标签存档后强制覆盖 #

适合不需要保留新旧版本历史关联的场景，操作步骤更简单：

• 切换到需要保留历史的旧分支，此处以目标覆盖分支main为例：
  git checkout main
• 给当前旧版本的最新提交打永久存档标签，可按版本语义命名，比如旧版本为v1.x系列：
  git tag v1-latest-legacy
• 将标签推送到远程仓库，确保所有成员都能访问到旧版本存档：
  git push origin v1-latest-legacy
• 切换到你的新版本开发分支，此处以v2-dev为例：
  git checkout v2-dev
• 强制推送新版本分支覆盖远程目标分支：
  git push origin v2-dev:main --force
  注意：如果目标分支开启了分支保护规则，需要先在仓库设置中临时放开强制推送权限；操作前同步所有团队成员，避免成员本地旧分支误推覆盖新版本

方案2：使用ours合并策略保留完整历史线（更推荐） #

适合需要在同一分支的提交记录中保留新旧版本完整关联的场景，无需强制推送，对团队协作更友好：

• 切换到你的新版本开发分支，此处以v2-dev为例：
  git checkout v2-dev
• 执行ours策略合并目标旧分支，该操作会将旧分支的所有历史纳入当前分支，但最终代码完全保留新版本的内容，不会产生合并冲突：
  git merge -s ours main
• 合并完成后直接推送到远程目标分支即可，不需要加强制推送参数：
  git push origin v2-dev:main
  操作完成后查看目标分支的提交历史，可以同时看到旧版本的所有提交记录和新版本的开发记录，历史追溯更连贯。

NPM包发布额外注意事项 #

• 新版本号需要严格遵循语义化版本规范，版本号必须高于所有已发布的旧版本，比如旧版本最高为1.9.9，新版本直接升至2.0.0即可，避免npm版本分发出现优先级异常
• 如果需要保留旧版本的安装入口，可执行npm dist-tag add <你的包名>@<旧最新版本号> legacy，用户可通过npm install <包名>@legacy安装旧版本

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