无Git历史的代码如何优雅合并?附冲突解决方案

Posted by abining on February 11, 2025

真实场景复现

上周团队遇到了典型的多环境协作问题:

  • 主仓库在内网服务器(无法外网访问)
  • 同事在外网开发时直接复制整个项目文件夹
  • 交回代码时只有文件目录,没有.git文件夹

这时候直接覆盖文件会面临:

  1. 丢失所有commit记录
  2. 无法追溯代码变更
  3. 难以处理多人协作冲突

解决方案很多,我分享一下我的方案

创建"孤儿分支"保留开发记录

1. 创建同事的开发分支,并且推送到远程

1
2
3
4
5
6
7
8
9
10
# 在同事的代码目录操作
cd colleague-project/
git init
git checkout --orphan colleague-work # 创建无历史分支
git add .
git commit -m "同事完整开发记录"

# 推送到主仓库
git remote add origin git@xxx.com:project.git
git push origin colleague-work # 把同事的开发分支推送上去

这样做的优势

  • 独立分支保留完整开发历程
  • 不与主分支历史混淆
  • 方便code review时diff查看

2. 将同事的分支合并到我的分支(dev-abining)

来,手把手教你如何丝滑合并孤儿分支到dev-abining分支!

现在是这样的:远程仓库有至少两个分支:1. 我的开发分支(dev-abining)2. 同事刚刚推送过去的分支(colleague-work)

1
2
3
4
5
6
# 在你的本地仓库操作
git remote add colleague-project /path/to/colleague-project # 指向同事本地目录
# 或如果是远程仓库:
git remote add colleague-project git@xxx.com:colleague-repo.git

git fetch colleague-project colleague-work # 拉取同事的孤儿分支

没想到吧,git竟然能添加一个本地的仓库作为当前仓库的远程仓库。

我要是没写这文章,我都不知道。

fetch之后,就可以merge了

Step 2:使用三方合并策略

1
2
git checkout dev-abining # 切换到你自己的开发分支
git merge --allow-unrelated-histories colleague-project/colleague-work

关键参数说明
--allow-unrelated-histories 允许合并两个没有共同祖先的分支(孤儿分支必备参数)。

如果merge的时候没有这个参数,会报错:fatal: refusing to merge unrelated histories

tep 3:处理冲突

  1. 推荐使用VS Code的GitLens插件
  2. 或者手动修改冲突文件。

这时候:传入的分支是colleague-project/colleague-work,如果需要一律采用传入的更改

1
git checkout --theirs .

Step 4:提交合并结果

1
2
git add . # 添加所有解决后的文件
git commit -m "feat: 合并同事分支(colleague-work)到dev-abining"

注意事项

  1. 合并前务必运行 git diff colleague-project/colleague-work 预览差异
  2. 建议在合并后运行自动化测试:
1
2
npm run test # 或你的项目测试命令