最近把一个开发了很久的项目从公司的 svn 服务器迁移到 GitLab 上,折腾了几天。我们的 svn 目录结构不是很标准,所以网上的资料没一个能够照搬用的。Anyway,最后成功了,我这里详细记录一下,供参考。

本文地址:https://segmentfault.com/a/1190000007039598

Reference

SVN 迁移到GIT
svn迁移到Git
SVN迁移到Git的过程(+ 一些技巧)
git-svn 使用环境和步骤
git如何恢复本地删除的文件
git alternatives to “svn info” that can be included in a build for traceability?
svn2git
为git配置扩展命令
SVN、GIT生成版本号
git使用规范
Git 添加空文件夹的方法
转:批量查找空文件夹并放置.gitkeep或.gitignore
git add --all 为啥不能添加空文件夹,这样设计的初衷是?
git 为何不能添加空文件夹?
Git 里面的 origin 到底代表啥意思?
新手请教:Git 里面的 origin 到底代表啥意思?
git 查看分支 以及所对应的remote
.gitignore 不起作用
git 放弃本地修改更新
git 提交到本地但未push到远端的代码
Git 分支管理和冲突解决
git cherry-pick合并某个commit
Git错误non-fast-forward后的冲突解决
Git下的冲突解决
Git学习笔记05--git stash

看了好多资料……

Svn 代码库情况

我们的 svn 代码库的 URL 当然是机密啦。不过大致原理上,我需要迁移的目录状况如下:

主分支(在 git 上应成为 master 分支):
http://rdsvn.company.net/some_mid_path/Branches/main

此外打了几个tag:
http://rdsvn.company.net/some_mid_path/Branches/main_tag_25189
http://rdsvn.company.net/some_mid_path/Branches/main_tag_28141
http://rdsvn.company.net/some_mid_path/Branches/main_tag_28576

导出 svn 工程

首先,我们需要git-svn

$ sudo yum install git-svn
or
$ sodu apt-get install git-svn

原理上,就是使用git svn clone ...命令。如果你只是简单的执行这个命令的话:

$ git svn clone http://rdsvn.company.net/some_mid_path/Branches/main

那么我们只是将主分支及其 log 取到了本地,但是其他的分支并没有。如果要把所有的分支都 checkout 出来的话,需要用到--trunk--tags--branches等选项。

需要注意的有三点:

  1. 除了trunk单词是单数之外,其他的选项单词,请注意是复数。前者就是主分支的目录了,而后者表示的则是对应各个分支 / 标签的上层目录。Git-svn 会将该目录下的所有子目录视为一个独立的分支 / 标签进行导出。

  2. 这几个选项指定的都是相对路径,相对于你在git svn clone后面紧跟着的路径的位置。所以请不要在这些选项里面指定诸如 “http://” 开头的绝对地址。

  3. 除了 trunk 之外,其他几个相关选项可以重复指定。如果你的分支 / 标签分别在 svn 目录上的不同文件夹下,可以多次指定。

于是,对应我们的实际情况,git-svn 命令是这样的:

git svn clone http://rdsvn.company.net/some_mid_path/   \  # 注意这里并没有把主分支的路径写完整
--trunk="Branches/main" --tags="Branches"

稍等一会儿,就可以看到整个 svn 的主分支及分支都被导出来了,一颗赛艇!

分支处理

执行git branch -a可以看到相应的分支已经按照我们指定的选项建立起来了。我的实际情况,分支是这样的:

    trunk
    tags/main_tag_25189
    tags/main_tag_28141
    tags/main_tag_28576

这几个分支都被视为 Git 的远程分支,你的本地仓库暂时是空的。可以使用git checkout -b ...来将这几个分支拉到本地。

讲道理,svn 上的分支命名和 git 上的分支命名规则未必是一致的,因此这个时候你会想要重新命名分支。我的建议是这么操作:

  1. 在这个仓库中,首先把这几个虚拟的远程分支 checkout 到本地保存下来,这样可以保存 change log

  2. 向服务器上传主分支,一般分支名就是 master

  3. 将复制出来的其他分支,推到 git 服务器上,按照你希望的规则进行命名

上传到 git 服务器

首先要在 git 服务器上创建一个空的工程,比如 “git@rdgit.company.net/some_mid_path/some_group/firmware.git

然后在本地仓库中执行:

git remote add origin git@rdgit.company.net/some_mid_path/some_group/firmware.git

然后将主分支上传:

git push origin trunk:master

其他的分支也是利用这个语句创建新分支上传。

完成之后,在 git 服务器上就可以看到完整的 change log 以及分支变化情况啦。

关于空目录

其实迁移的时候还需要注意一个问题,那就是 svn 支持空目录的版本控制,但是 git 不支持。

导出 svn 之后,最好对比一下原始的 svn 工程内是否有空目录。如果有,那么你需要手工(或者写脚本)在导出的 git 工程中创建这些目录,并且在目录中建立一个 “.gitkeep” 文件(这是约定俗成的做法),并且将这些文件git add .gitkeep,以加入 git 的版本控制。这样就以迂回的方式通过 git 版本控制了目录。

如果觉得我的文章对你有用,请随意赞赏

会飞的猪 · 7月18日

版主遇到这样的问题了吗?
git svn clone 之后,本地是有文件的,提交到git之后只是增加了文件夹,但是文件却没有提交,且文件不可在add了?

回复

0

没有遇到哎,你先把文件备份一下,然后 git rm FILE --force ,然后再 git add 试试看?

amc 作者 · 7月21日
载入中...
amc amc

211 声望

发布于专栏

码农之路 - 原创笔记集

本专栏是栏主本人看了各种资料,自己理解之后记下的原创笔记。个人的理解可能会有所偏差,甚至错误,所以欢迎指正。绝大部分是基础知识,对编程新手来说,非常实用。

18 人关注