6.2.1. SVN 版本库到 Git 的迁移

Subversion版本库到Git版本库的转换，最好的方法就是git-svn。而git-svn的使用方法在前面“Git和SVN协同模型”一章已经详细介绍过。本章的内容将不再对git-svn的用法做过多的重复，只在这里强调一下版本库迁移时的注意事项，相关git-svn内容还请参照前面的内容。

在迁移之前要确认一个问题，Subversion转换到Git库之后，Subversion还继续使用么？意思是说还允许向Subversion提交么？

如果回答是，那么直接查看“Git和SVN协同模型”一章，用Git作为前端工具来操作Subversion版本库，而不要理会下面的内容。因为下面描述的迁移步骤针对的是一次性的Subversion到Git版本库的迁移。

需要提交中出现git-svn-id标识么？

如果一次性、永久性的将Subverison迁移到Git库，可以选择git-svn-id:标识不在转换后Git的提交日志中出现，这样转换后的Git库根本看不出来曾经用Subversion版本库维护过。

在git-svn的clone或者init子命令行中使用参数：--no-metadata。Git库的配置会自动配置svn-remote.noMetadata为1。之后执行git svn fetch时就不会在日志中产生git-svn-id:的标识。

Subversion用户名到Git用户名的映射

缺省转换后Git库的提交者ID为如下格式：userid <userid@SVN-REPOS-UUID>。即在邮件地址域名处以SVN版本库的UUID代替。可以在执行git svn fetch时通过下面的参数提供一个映射文件完成SVN用户名到Git用户名的转换。

-A<filename>, --authors-file=<filename>

即用-A或者--authors-file参数给出一个映射文件，这个文件帮助git-svn将Subversion用户名映射为Git用户名。此文件的每一行定义一个用户名映射，每一行的格式为：

loginname = User Name <user@example.com>

也可以通过下面的命令在Git库的config文件中设置，这样就不必在每次执行git svn fetch都带上这个参数。

$ git config svn.authorsfile /path/to/authersfile

当设定了用户映射文件后，如果在执行git svn fetch是发现SVN的用户在该映射文件中没有定义，转换过程被中断。需要重新编辑用户映射文件，补充新的用户映射后，再重新执行git-svn命令。

将Subversion分支和里程碑直接转换为Git分支和里程碑，不要放在``refs/remotes``下

使用缺省参数执行SVN到Git的转换时，SVN的里程碑和分支转换到Git库的refs/remotes引用下。这会导致其他人从转换后的Git库克隆时，看不到Subversion原有的分支和里程碑。

当以缺省参数执行git svn init时，Git的配置文件中会生成下面的配置：

[svn-remote "svn"]
        fetch = trunk:refs/remotes/trunk
        branches = branches/*:refs/remotes/*
        tags = tags/*:refs/remotes/tags/*

可以直接编辑Git配置文件，将其内容调整如下：

[svn-remote "svn"]
        fetch = trunk:refs/heads/master
        branches = branches/*:refs/heads/*
        tags = tags/*:refs/tags/*

之后再执行git svn fetch后，就可以实现SVN的分支和里程碑正确的转换为Git库的里程碑。否则就需要将.git/refs/remots/下的引用移动到.git/refs/heads以及.git/refs/tags下。

清除git-svn的中间文件

git-svn的中间文件位于目录.git/svn下，删除此目录完成对git-svn转换数据库文件的清理。