Git-svn clone

Posted 2021-03-31 Git开源社区

有了可以写入的 Subversion 仓库以后，就可以尝试一下典型的工作流程了。我们从 git svn clone 命令开始，它会把整个 Subversion 仓库导入到一个本地的 Git 仓库中。提醒一下，这里导入的是一个货真价实的 Subversion 仓库，所以应该把下面的 file:///tmp/test-svn 换成你所用的 Subversion 仓库的 URL：

$ git svn clone file:///tmp/test-svn -T trunk -b branches -t tags
 Initialized empty Git repository in /Users/schacon/projects/testsvnsync/svn/.git/
 r1 = b4e387bc68740b5af56c2a5faf4003ae42bd135c (trunk)
 A m4/acx_pthread.m4
 A m4/stl_hash.m4
 ...
 r75 = d1957f3b307922124eec6314e15bcda59e3d9610 (trunk)
 Found possible branch point: file:///tmp/test-svn/trunk => \
 file:///tmp/test-svn /branches/my-calc-branch, 75
 Found branch parent: (my-calc-branch) d1957f3b307922124eec6314e15bcda59e3d9610
 Following parent with do_switch
 Successfully followed parent
 r76 = 8624824ecc0badd73f40ea2f01fce51894189b01 (my-calc-branch)
 Checked out HEAD:
 file:///tmp/test-svn/branches/my-calc-branch r76

这相当于针对所提供的 URL 运行了两条命令—— git svn init 加上 git svn fetch 。可能会花上一段时间。我们所用的测试项目仅仅包含 75 次提交并且它的代码量不算大，所以只有几分钟而已。不过，Git 仍然需要提取每一个版本，每次一个，再逐个提交。对于一个包含成百上千次提交的项目，花掉的时间则可能是几小时甚至数天。

-T trunk -b branches -t tags 告诉 Git 该 Subversion 仓库遵循了基本的分支和标签命名法则。如果你的主干(译注：trunk，相当于非分布式版本控制里的master分支，代表开发的主线），分支或者标签以不同的方式命名，则应做出相应改变。由于该法则的常见性，可以使用 -s 来代替整条命令，它意味着标准布局（s 是 Standard layout 的首字母），也就是前面选项的内容。下面的命令有相同的效果：

$ git svn clone file:///tmp/test-svn -s

现在，你有了一个有效的 Git 仓库，包含着导入的分支和标签：

$ git branch -a
 * master
 my-calc-branch
 tags/2.0.2
 tags/release-2.0.1
 tags/release-2.0.2
 tags/release-2.0.2rc1
 trunk

值得注意的是，该工具分配命名空间时和远程引用的方式不尽相同。克隆普通的 Git 仓库时，可以以 origin/[branch] 的形式获取远程服务器上所有可用的分支——分配到远程服务的名称下。然而 git svn 假定不存在多个远程服务器，所以把所有指向远程服务的引用不加区分的保存下来。可以用 Git 探测命令 show-ref 来查看所有引用的全名。

$ git show-ref
 1cbd4904d9982f386d87f88fce1c24ad7c0f0471 refs/heads/master
 aee1ecc26318164f355a883f5d99cff0c852d3c4 refs/remotes/my-calc-branch
 03d09b0e2aad427e34a6d50ff147128e76c0e0f5 refs/remotes/tags/2.0.2
 50d02cc0adc9da4319eeba0900430ba219b9c376 refs/remotes/tags/release-2.0.1
 4caaa711a50c77879a91b8b90380060f672745cb refs/remotes/tags/release-2.0.2
 1c4cb508144c513ff1214c3488abe66dcb92916f refs/remotes/tags/release-2.0.2rc1
 1cbd4904d9982f386d87f88fce1c24ad7c0f0471 refs/remotes/trunk

而普通的 Git 仓库应该是这个模样：

$ git show-ref
 83e38c7a0af325a9722f2fdc56b10188806d83a1 refs/heads/master
 3e15e38c198baac84223acfc6224bb8b99ff2281 refs/remotes/gitserver/master
 0a30dd3b0c795b80212ae723640d4e5d48cabdff refs/remotes/origin/master
 25812380387fdd55f916652be4881c6f11600d6f refs/remotes/origin/testing

这里有两个远程服务器：一个名为 gitserver ，具有一个 master分支；另一个叫 origin，具有 master 和 testing 两个分支。

注意本例中通过 git svn 导入的远程引用，（Subversion 的）标签是当作远程分支添加的，而不是真正的 Git 标签。导入的 Subversion 仓库仿佛是有一个带有不同分支的 tags 远程服务器。