git-svn：通过git来管理svn代码

sunren

简介
　　svn和git都是常用的版本管理软件，但是git无论在理念或是功能上都比svn更为先进。但是有的公司是以svn作为中央仓库，这时git与svn代码的同步就可以通过 git-svn这个软件进行，从而用git管理svn代码。最后的效果相当于把svn仓库当作git的一个remote（远程仓库），而你本地的代码都是通过git来管理，只有push到svn时才会把你本地的commit同步到svn。

从svn克隆
　　首先看一看用于测试的svn项目结构，svn的仓库路径是file:///d/Projects/svn_repo，可以用svnadmin create svn_repo命令新建。该仓库有2个分支，1个tag，属于svn标准布局。
　　SVN项目结构：
　　

/d/proj1　　├── branches
　　│   ├── a
　　│   │   └── readme.txt
　　│   └── b
　　│       ├── 11.txt
　　│       └── readme.txt
　　├── tags
　　│   └── v1.0
　　│       ├── 11.txt
　　│       └── readme.txt
　　└── trunk
　　└── readme.txt
　　

　　命令格式：git svn clone <svn仓库路径> [本地文件夹名] [其他参数] 相当于git clone
　　示例： git svn clone file:///d/Projects/svn_repo proj1_git -s --prefix=svn/
　　参数说明：

• -s 告诉 Git 该 Subversion 仓库遵循了基本的分支和标签命名法则，也就是标准布局。　　如果你的主干(trunk，相当于非分布式版本控制里的master分支，代表开发的主线），分支(branches)或者标签(tags)以不同的方式命名，则应做出相应改变。
  　　-s参数其实是-T trunk -b branches -t tags的缩写，这些参数告诉git这些文件夹与git分支、tag、master的对应关系。
  
  
• --prefix=svn/ 给svn的所有remote名称增加了一个前缀svn，这样比较统一，而且可以防止warning: refname 'xxx' is ambiguous.
  

　　现在，看下用git-svn克隆的项目情况（运行git branch -a），此处git的分支情况是与svn文件夹对应的。
　　

* master　　remotes/svn/a
　　remotes/svn/b
　　remotes/svn/tags/v1.0
　　remotes/svn/trunk
　　


只下载指定版本之后的历史
　　如果svn上的commit次数非常多, git svn clone 就会非常慢，一般超过几百个版本就要大概十分钟。此时可以在clone的时候只下载部分版本，
　　命令：git svn clone -r<开始版本号>:<结束版本号> <svn项目地址> [其他参数]
　　示例：git svn clone -r2:HEAD file:///d/Projects/svn_repo proj1_git -s
　　说明：其中2为svn版本号，HEAD代表最新版本号，就是只下载svn服务器上版本2到最新的版本的代码.

工作流程
　　简单来说就是，首次新建分支会记录和svn远程对应分支的追踪关系，之后你的所有commit都是在本地的；并且和纯git管理的项目没有区别，只是在git svn rebase和git svn dcommit的时候才会和svn仓库发生关系

一般工作流程（推荐）

• 新建分支git checkout -b <本地分支名称> <远程分支名称>　　示例：git checkout -b a svn/a
  　　说明：此处新建了一个本地分支a，与svn的a分支对应。
  
  
• 在本地工作，commit到对应分支上
  
• git svn rebase 从svn上更新代码, 相当于svn的update。
  
• git svn dcommit 提交你的commit到svn远程仓库，建议提交前都先运行下git svn rebase。
  

在git本地其他分支工作的情况

• git chechout -b a svn/a 此处新建了一个本地分支a，与svn的a分支对应。
  
• git checkout -b feature1 在a分支的基础上，开一个本地feture1分支
  
• 在feture1分支进行开发，有了多次commit
  
• 在feture1分支上进行git svn rebase 和 git svn dcommit，这样feature1的commit也会提交到svn的a分支上。　　需要注意的是要记住feture1是从哪个分支checkout的，它的svn远程分支就与哪个相同。比如此处是a分支，那么svn分支就是svn/a，commit就会提交到svn的a分支。
  

SVN分支管理

新建分支到svn
　　命令：git svn branch <分支名称>
　　示例：git svn branch c_by_git
　　说明：在svn仓库上建了了一个c_by_git分支
　　分支情况
　　

  a　　* master
　　remotes/svn/a
　　remotes/svn/b
　　remotes/svn/c_by_git
　　remotes/svn/tags/v1.0
　　remotes/svn/trunk
　　


删除svn分支

• 删除svn分支目录svn rm <svn分支路径> -m <commit信息>　　示例：svn rm file:///d/Projects/svn_repo/branches/c_by_git -m 'rm branch'
  
  
• 删除远程跟踪分支git branch -D -r <远程分支名称>　　示例：git branch -D -r svn/c_by_git
  

SVN上tag管理

新建tag
　　命令：git svn tag <tag名称>
　　示例：git svn tag v1.1
　　说明：在svn仓库上建了一个v1.1tag

删除tag

• 　　删除svn目录svn rm <svntag路径> -m <commit信息>
  　　示例：svn rm file:///d/Projects/svn_repo/tags/v1.1 -m 'rm tag'
  
  
• 　　删除远程跟踪分支git branch -D -r <远程分支名称>
  　　示例：git branch -D -r svn/tags/v1.1
  　　说明：svn的tag和分支在git看来是一样的，所以此处还是用的git branch
  

冲突解决
　　如果本地和svn都进行了修改，则不能快速前进，git svn rebase 会出现错误。
　　这时应该按以下步骤操作：

• 　　手动修改冲突文件，修改完成后git add
  
  
• 　　git rebase --continue
  
  
• 　　git svn dcommit
  

svn不遵循规范的情况
　　以上讲的都是svn仓库是标准的情况，如果不标准，则以下几个地方都会有所不同。主要就是每个步骤基本都要添加svn的具体路径。
　　先看看，示例项目的结构，仓库路径是file:///d/Projects/svn_repo2。这个项目主分支是dev文件夹，branch1和tag1文件夹分别代表的是一个分支和tag。
　　svn项目结构：
　　

/d/proj2　　├── branch1
　　│   └── file1.txt
　　├── dev
　　│   └── file1.txt
　　└── tag1
　　└── file1.txt
　　


从svn克隆
　　命令：git svn clone <svn项目地址，要包含具体分支路径> [本地文件夹名]
　　示例：git svn clone file:///d/Projects/svn_repo2/dev proj2_svn

添加远程分支信息
　　命令：

• git config --add svn-remote.<远程分支名称>.url <svn地址，要包含具体分支路径>
  
• git config --add svn-remote.<远程分支名称>.fetch :refs/remotes/<远程分支名称>
  

　　示例：

• git config --add svn-remote.svn/branch1.url file:///d/Projects/svn_repo2/branch1
  
• git config --add svn-remote.svn/branch1.fetch :refs/remotes/svn/branch1
  

　　说明：此处的“远程分支名称”可以随意填写，只要这三个保持一致即可。建议都给他们增加svn/前缀，这样svn的所有分支显示起来会比较一致，与上面clone时的--prefix=svn/类似。

新建本地分支，与svn对应
　　命令：

• git svn fetch <远程分支名称> 获取svn仓库该分支的代码
  
• git checkout -b <本地分支名> <远程分支名称>
  

　　示例：

• git svn fetch svn/branch1
  
• git checkout -b branch1 svn/branch1
  

　　分支情况：
　　

* branch1　　master
　　remotes/git-svn
　　remotes/svn/branch1