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

简介

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项目结构:

1
2
3
4
5
6
7
8
9
10
11
12
13
/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文件夹对应的。

1
2
3
4
5
* 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 rebasegit svn dcommit的时候才会和svn仓库发生关系

一般工作流程(推荐)

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

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

  1. git chechout -b a svn/a 此处新建了一个本地分支a,与svn的a分支对应。
  2. git checkout -b feature1 在a分支的基础上,开一个本地feture1分支
  3. 在feture1分支进行开发,有了多次commit
  4. 在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分支
分支情况

1
2
3
4
5
6
7
  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

  1. 删除svn目录svn rm <svntag路径> -m <commit信息>
    示例:svn rm file:///d/Projects/svn_repo/tags/v1.1 -m 'rm tag'

  2. 删除远程跟踪分支git branch -D -r <远程分支名称>
    示例:git branch -D -r svn/tags/v1.1
    说明:svn的tag和分支在git看来是一样的,所以此处还是用的git branch

冲突解决

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

  1. 手动修改冲突文件,修改完成后git add

  2. git rebase --continue

  3. git svn dcommit

svn不遵循规范的情况

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

svn项目结构:

1
2
3
4
5
6
7
/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

添加远程分支信息

命令:

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

示例:

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

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

新建本地分支,与svn对应

命令:

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

示例:

  1. git svn fetch svn/branch1
  2. git checkout -b branch1 svn/branch1

分支情况:

1
2
3
4
* branch1
master
remotes/git-svn
remotes/svn/branch1
上一篇:msysGit管理GitHub代码


下一篇:Linux环境下的GCC编译器与GDB调试工具介绍