实际操作 Svn 迁移到 Git

最近把一个开发了很久的项目从公司的 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 服务器上创建一个空的工程，比如 “[e-mail]/some_mid_path/some_group/firmware.git”

然后在本地仓库中执行：

git remote add origin [e-mail]/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 版本控制了目录。