svn项目迁移到git

前言

最近刚把公司项目从svn迁移到了git上，在这里做个记录

数据迁移

# 检出空项目proj
svn co --depth=empty --username=user svn://url proj

# 进入proj目录
cd proj

# 获取user列表
svn log ^/ --xml | grep -P "^<author" | sort -u | perl -pe 's/<author>(.*?)<\/author>/$1 = $1 <\@email.com>/' > ../users.txt

# 对users.txt进行编辑 替换用户名和邮箱内容

cd ../ && rm -rf proj

# 检出svn r1版本到最新版本的数据
git svn clone -r1:HEAD svn://url --username=user --no-metadata --authors-file=users.txt proj

执行上面的步骤就可以将svn项目导出到本地git仓库了。不过，一般项目比较大导出时间会比较长，可以中断 git svn clone 操作，采用下面的命令分段迁移，避免长时间运行把电脑弄卡或者死机：

# 进入proj目录
cd proj

# 更新远程分支 git-svn 
git svn fetch

# 合并远程分支 git-svn 到 master 分支
git merge git-svn

# 如果迁移过程中svn地址有变动，可以修改 .git/config 文件中对应的url

这里说一个迁移的细节，可以提早进行 git svn clone 操作，在下班的时候 git svn fetch 快速更新到最新版本然后停掉svn服务器。

多模块项目拆分

我们的项目是一个maven多模块项目，原先在svn下可以给不同的人开放不同子模块的权限，而git无法做到目录级权限控制，所以能想到的解决办法就是拆拆拆。不过，我们项目的子模块比较多(20多个)，全拆感觉会要命，就简单拆成前端和后端两个仓库吧。

# 1. 将子模块 [module1] 拆分为新的分支 module1
git subtree split -P module1 -b module1

# 2. 清理 master 分支中包含子模块 [module1] 的内容
git filter-branch -f --index-filter "git rm -rf --cached --ignore-unmatch module1" --prune-empty master

# 3. 将子模块推送到新仓库的master分支
git push http://gitlab/module1.git module1:master

需要深入使用 subtree 可以参考下面步骤, 不过个人认为subtree的引用在日常开发中不是很方便，还不如工作空间下引入多个项目。

# 4. 父模块引入新的仓库作为子模块
git subtree add --prefix=module1 http://gitlab/module1.git master

# 5. 父模块中 pull 子模块的数据
git subtree pull --prefix=module1 http://gitlab/module1.git master

# 6. 父模块向子模块 push
git subtree push --prefix=module1 http://gitlab/module1.git master

遇到的问题

• 耗时
  git svn clone, git subtree split, git filter-branch 这三个步骤非常的耗时，需要合理安排时间, 中途要经常备份。我们的项目有3w+的commits,在 i5 8g 的 win10 上耗时分别为 30h, 2h, 10h，迁移后项目大小300M。中途遇到过 蓝屏重启后索引错乱需要重头再来、内存泄漏导致死机(单独开篇讲)、svn服务器经常断开连接 等等问题。

• 空目录
  迁移后，原先的空目录会被删除，如果需要保持原有目录结构，可以在空目录下添加占位文件并提交到svn上，之后再导入git。参考 git提交空文件夹

• 换行符的问题
  在svn上这个不算什么大问题，迁移到了git上之后就成了大问题，因为有autocrlf这个配置项。一般人安装git的时候要么选择默认设置，要么被网上的文章误导一顿操作结果越设置越乱。解决方法：

源码在仓库中统一用LF格式保存
在Mac上设置 autocrlf = input (检出的时候不转换，提交的时候自动转成LF)
在Windows上设置 autocrlf = true (检出的时候自动转成CRLF, 提交的时候自动转成LF)

我们的项目比较可怕，是CRLF文件和LF文件混合的，可以采用下面的命令批量替换，然后提交到svn上

# 修改svn项目的换行符(linux下或者进入git-bash执行)
find . -type f -print -o -path ./.svn -prune | xargs dos2unix -k

对了，迁移完最好使用 Beyond Compare 4 这样的工具对比下。

• 其他问题
  • 迁移用的svn帐号最好有所有目录的权限
  • users.txt 中加一行 (no author) = no_author <no_author@no_author>
  • 最好用 linux 服务器迁移，耗时能从以 小时 为单位提升到以 分钟 为单位，而且可以同时进行多个项目的迁移。

参考

SVN迁移到git

Git 仓库拆拆拆

Git多仓库作子目录的双向同步：一次Git Subtree的实践

Windows文件换行符转Linux换行符

结语

整个迁移步骤就上面简单的几步就好了, 剩下的就是把本地仓库push到远程仓库(如 gitlab )中即可, 至于其他的坑各位自行体验吧。

转载请注明出处：https://www.jianshu.com/p/5dcf658851f7