与《SVN迁移至GitLab,并附带历史提交记录》用的 git svn clone
不同,本文使用svn2git来迁移项目代码。
一、准备工作
- 安装Git环境,配置本地git账户信息:
bash
git config --global user.name "XXX"
git config --global user.email "XXX@mail.com"
可通过命令git config -l 查看结果
- 安装
git-svn
,运行git svn -h
,若正常输出帮助信息,说明安装没问题。 - 安装
ruby
,运行ruby -h
,若正常输出帮助信息,说明安装没问题。 - 执行下面命令安装svn2git,注意下面命令依赖ruby。
bash
gem install svn2git
再运行svn2git -h
,若正常输出帮助信息,说明安装没问题。
-
svn账号与git账号映射,新建文件 userinfo.txt,左侧是SVN的账号,右侧是git账号信息,用=号连接:
svn1=git1git1@mail.com
svn2=git2git2@mail.com
svn3=gitxgitx@mail.com
注意:
- 需要将涉及到的同步记录中的用户都做映射,否则在同步时可能会报错
- 对于无法对应的人员,如离职人员,有SVN账号,但是没有现在的GIT账号,保险起见,可以采用无关紧要的账号进行对应,或者单独建一个账号也可以,例如使用的test账号进行标识的
二、导出SVN项目至本地
-
创建空文件夹用于存放SVN的代码,并将userinfo.txt文件放置在同一层级
│ userinfo.txt
└─ MyProject -
鼠标右键 选中Git Bash Here 进入git命令行,执行:
bash
svn2git svnUrl --authors userinfo.txt -v
这里的
-v
会输出执行过程的信息,方便debug。此处的 -r 12345:HEAD 表示从svn的12345版本到最新版本的提交记录,避免拉取所有数据量过大,操作耗时高。svnurl是svn项目地址。如果需要拉取所有记录,可去除 -r 12345:HEAD
如果在windows有下面错误:
D:\MyProject>svn2git https:/xxx.com:8443/svn/SVN2GIT/ --authors authors.txt -v
Running command: git svn init --prefix=svn/ --no-metadata --trunk='trunk' --tags='tags' --branches='branches' https:/xxx.com:8443/svn/SVN2GIT/
Initialized empty Git repository in D:/MyProject/.git/
Running command: git config --local --get user.name
Running command: git config --local svn.authorsfile authors.txt
Running command: git svn fetch
Running command: git branch -l --no-color
Running command: git branch -r --no-color
Running command: git config --local --get user.name
Running command: git config --local --get user.email
Running command: git checkout -f master
error: pathspec 'master' did not match any file(s) known to git
command failed:
git checkout -f master
去安装目录C:\Ruby30-x64\lib\ruby\gems\3.0.0\gems\svn2git-2.4.0\lib\svn2git
,找到migration.rb
文件,把#{trunk}
、 #{tag}
、#{branch}
两边的单引号删除,再重新执行上面命令。
三、与远程git仓库关联起来
- 进入项目文件夹,
bash
cd MyProject
- 关联远程事先创建好的git项目
bash
git remote add origin gitURL
如:git remote add origin http://192.168.1.xx:5678/MyProject.git
- 查看关联情况:
bash
git remote -v
- 如果关联有误,可以删除关联
bash
git remote rm origin
- 推送本地项目到git仓库
- 提交记录之前,先拉取远程git项目文件(如:README.md),否则直接提交会报错
bash
git pull --rebase origin master
- 拉取成功后,执行push命令
bash
git push -u origin master
执行命令后,可能会弹窗要求输入Git的账号和密码