《Git/Gitlab进阶》十五:合并两个项目为一个并保留合并前所有历史记录

作者 : 开心源码 本文共3584个字,预计阅读时间需要9分钟 发布时间: 2022-05-13 共271人阅读

本章主要测试讲解

  • 如何将两个 git 管理的项目合并成一个项目,并保留住各自项目中所有的历史提交记录。(后续可以自行拓展到三个、四个……的合并)

本篇内容,不建议跳过,假如有这个需求,还请仔细详细查看,谢谢。

测试过程

前置说明

git 管理的项目合并,还要保留之前的提交历史记录,则表明不能直接异动到原项目.git 文件夹仓库,需要通过其它方式把子项目的.git 文件夹合并到一起,才能保存住所有提交信息。

项目准备

  • 先从 github 克隆了两个项目用于测试,一个是 dayjs,一个是 moment;
  • 计划是把 dayjs 和 moment 合并为一个项目,名为 timetools;
    • 该项目包含两个文件夹,一是 dtool,对应本来的 dayjs;
    • 二是 mtool,对应本来的 moment。

效果,合并前

- dayjs                 => 独立的 dayjs 项目,有自己的.gitignore 和 .git/- moment                => 独立的 moment 项目,有自己的.gitignore 和 .git/

合并后:

- timetools/            => 即最开始的 dayjs,整合完后更名  - .gitignore          => 合并两个 repos 的忽略文件  - .git/               => 最终仅余一个 repo  + dtool/              => 对应 dayjs  + mtool/              => 对应 moment

克隆的项目,内容如下:

1.png

使用git log --oneline | wc -l获取提交数量。

粗略可见,dayjs 的提交为 1046 次,moment 提交为 3724 次。
注意分支名,dayjs 为 dev,moment 为 develop。

大概流程

  • 1 进入 dayjs 文件夹,将 moment 作为远程仓库增加到 dayjs 来;
  • 2 合并增加的库 moment 到本来的 dayjs 项目;
  • 3 创立 mtool 文件夹,把 moment 的 develop 分支合并到 mtool 文件夹;
  • 4 完成 moment 转移提交;
  • 5 完成 dayjs 文件的迁移;
  • 6 完成项目合并并查看历史记录。

测试步骤

进入 dayjs 文件夹,将 moment 作为远程仓库增加到 dayjs 来

使用命令:

git remote add -f moment D:/davidsu/Desktop/GitlabTest/full/moment

命令说明:
git remote add 增加远程仓库路径

  • -f 的作用是在增加后立刻 fetch。
  • D:/davidsu/Desktop/GitlabTest/full/为需要被合并 moment 项目的绝对路径 。

如下图:

2.png

合并增加的库 moment 到本来的 dayjs 项目

使用命令(注意分支名):

git merge --strategy ours --no-commit --allow-unrelated-histories moment/develop

命令说明:
git merge 为合并分支

  • –strategy ours 解析合并,在合并时,假如遇到冲突,以我的为准。(本例是在 dayjs 中合并 moment,遇到冲突以 dayjs 的为准)。结果就是:
    • moment 的历史记录被合并到 dayjs 的历史记录中。
    • moment 的文件树被读取并和 dayjs 的文件树比对进行冲突解析。
  • –no-commit 合并解析完成后中断,停留在最后的提交步骤之前。
    • 只需你还没 commit,那么 merge 的结果就暂时保存在缓存区中,只有完成提交步骤合并才算彻底完成(文件树被正式改变)。
  • –allow-unrelated-histories 允许合并无关的历史记录。
    • 假如不增加此选项,可能会出现fatal: refusing to merge unrelated histories错误。

如下图:

3.png

创立 mtool 文件夹,把 moment 的 develop 分支合并到 mtool 文件夹

使用命令:

mkdir mtool    # 创立文件夹git read-tree --prefix=mtool/ -u moment/develop

命令说明:
git read-tree 给定的树信息读入索引

  • –prefix 用于指定文件树读取后保存的路径,相对于当前路径并且肯定要追加 /。
  • -u 是说在读取后升级 index,使得 working tree 与 index 保持同步。

这个命令的意义在于,之前的git merge命令可能会在处理冲突的时候,把 moment 的文件树弄得比较混乱,再使用read-tree去修复一下。

如下图(再次提示,=前后不要空格):

4.png

完成 moment 转移提交

上一步已经修复了文件数,执行完之后,依然在 MERGING 状态,需要提交一次修改。

使用命令:

git commit --message '完成moment 的迁移,新目录为 mtool'

如下图(MERGING 过成已完成):

5.png

完成 dayjs 文件的迁移

以上,已把 momet 项目迁移到了 dayjs 下的 mtool 文件夹了。现在要迁移 dayjs 文件夹了。

在 dayjs 文件夹下,新建文件夹 dtool

mkdir dtool

再把所有本来属于 dayjs 的文件移动到新建的 dtool 去。
也就是除了 dtool/、mtool/、.git/、.gitignore 之外的所有。

剪切完之后,把这个本来的 dayjs 的文件夹重命名为 timetools。

完成项目合并并查看历史记录

到这一步,本来的 dayjs 项目,就变成了 timetools 项目,里面的 dtool 文件夹就是 dayjs 项目。

不过还差一点,之前只是把文件放进去了,还需要合并.gitignore 文件。

在新的 timetools 文件夹下,运行:

cat mtool/.gitignore >> .gitignore

把本来 moment 项目,现在的 mtool 文件夹下的.gitignore 的内容,合并到现在 timetools 文件夹下的.gitignore 中,完成忽略文件的合并。

如下图:

6.png

到这里,合并作业就基本完成了,最后在增加提交一次,做合并项目的记录

git add --all;git commit --message '迁移整合完成!'

如下图:

7.png

合并前后的文件夹结构如下:

8.png

查看合并后的项目历史记录,如下图:

9.png

提交数:4772 = 1046 + 3724 + 2。

总结

以上,完成了两个项目合并到一个项目的示例接操作演示,后续有更多的项目想要合并,可以相似。

本示例使用步驟

  • 进入 dayjs
  • git remote add -f moment D:/davidsu/Desktop/GitlabTest/full/moment
  • git merge –strategy ours –no-commit –allow-unrelated-histories moment/develop
  • mkdir mtool
  • git read-tree –prefix=mtool/ -u moment/develop
  • git commit –message ‘完成 moment 的迁移,新目录为 mtool’
  • mkdir dtool (还在 dayjs 下面)
  • 拷贝 dayjs 的原始项目文件(除了 .git/ 和 .gitignore 以外)至 dtool/;
  • 拷贝完之后,可以把本来文件夹名 dayjs 改为 timetools;
  • 把此时 mtool 下的.gitignore 文件内容,整理合并到 timetools 下的.gitignore 文件中去。
  • 合并完之后,再一律增加提交一次,做为整合操作的记录:
    • git add –all; git commit –message ‘迁移整合完成!’

整理引用原作者步骤:
目标:将 frontend 项目与 backend 项目,合并到 project 项目下的 client 文件夹与 server 文件夹。

  1. $ [~] cd frontend
  2. $ [frontend] git remote add -f backend /fullpath/to/backend
  3. $ [frontend] git merge --strategy ours --no-commit backend/master
  4. $ [frontend] mkdir -p server
  5. $ [frontend] git read-tree --prefix=server/ -u backend/master
  6. $ [frontend] git commit --message '完成 backend 的迁移,新目录为 server'
  7. $ [frontend] mkdir -p client
  8. # 拷贝 frontend 的原始项目文件(除了 .git/ 和 .gitignore 以外) 至 client/
  9. $ [frontend] cd ..; mv frontend/ project/; cd project
  10. $ [project] cat server/.gitignore >> .gitignore
  11. # 整理合并后的 .gitignore,修复其中的路径缺失并保存;修复各种项目依赖的缺失,本地测试。
  12. $ [project] git add --all; git commit --message '迁移整合完成!'

参考文件:
https://segmentfault.com/a/1190000000678808

说明
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是摆设,本站源码仅提供给会员学习使用!
7. 如遇到加密压缩包,请使用360解压,如遇到无法解压的请联系管理员
开心源码网 » 《Git/Gitlab进阶》十五:合并两个项目为一个并保留合并前所有历史记录

发表回复