前言
最近刚把公司项目从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 )中即可, 至于其他的坑各位自行体验吧。
网友评论