6.2.2. Hg 版本库到 Git 的迁移

优质

小牛编辑

133浏览

2023-12-01

Mercurial（水银）是和Git同时代的、与之齐名的一款著名的分布式版本控制系统，也有相当多的使用者。就像水银又名汞，作为版本控制系统的Mercurial又称作Hg（水银元素符号）。Hg具有简单易用的优点，至少Hg提交的顺序递增的数字编号让Subversion用户感到更为亲切。Hg的开发语言除少部分因性能原因使用C语言外，大部分用Python语言开发完成，因而更易扩展，最终形成了Hg最具特色的插件系统。例如MQ就是Hg一个很有用的插件，通过Quilt式的补丁集实现对定制开发的特性分支的版本控制，当然StGit和Topgit也可以实现类似的功能。

但是Hg存在一些不足。例如服务器的存储效率不能和Git相比，服务器存储空间占用更大。Hg还不支持真正的分支，只能通过版本库克隆来进行分支开发。因为Hg不支持真正的分支，所以不能向git-svn那样完整的将Subversion版本库转换和互操作。Hg的速度相比Git要慢，尤其是网络操作没有像Git一样精确的进度显示。Hg提交只能回退一次，要想多次回退和整理版本库需要用到MQ插件。作为定制开发的利器“Hg+MQ”不适合多人协作开发而“Git+Topgit”更为适合。

不论是何原因想从Hg迁移到Git，用一个名为fast-export的转换工具可以很方便的实现。fast-export是一个用Python开发的命令行工具，可以将本地的Hg版本库迁移为Git版本库。其原理和CVS版本库迁移至Git时使用的cvs2git相仿，都是先从源版本库生成导出文件，再用Git的通用版本库转换工具git fast-import导入到新建的Git版本库中。

安装fast-export非常简单，只要用Git克隆fast-export的版本库即可。

$ cd /path/to
$ git clone git://repo.or.cz/fast-export.git

完成克隆后，会看到/path/to/fast-export目录中有一个名为hg-fast-import.sh的脚本文件，该文件封装了对相应Python脚本的调用。使用该脚本可以实现Hg版本库到Git版本库的迁移。

下面就演示一下Hg版本库到Git版本库的转换。

要转换的Hg版本库位于路径/path/to/hg/hello/.hg下。

Hg不支持真正的分支，而且版本库中可能存在尚未合并的多个头指针。检查一下不要存在具有相同分支名但尚未合并的多个头指针，否则转换会失败。下面显示的该Hg版本库中具有两个具名分支r1.x和next，还有一个缺省未设置名称的头指针，因为分支名各不相同所以不会为转换过程造成麻烦。

$ hg heads
修改集:      7:afdd475caeee
分支:        r1.x
标签:        tip
父亲:        0:798a9568e10e
用户:        Jiang Xin <jiangxin@ossxp.com>
日期:        Fri Jan 14 17:01:47 2011 +0800
描述:
start new branch: r1.x


修改集:      6:7f5a46201dda
分支:        next
用户:        Jiang Xin <jiangxin@ossxp.com>
日期:        Fri Jan 14 17:01:04 2011 +0800
文件:        src/locale/zh_CN/LC_MESSAGES/helloworld.po
描述:
imported patch 100_locale_zh_cn.patch


修改集:      1:97f0a21021c6
用户:        Jiang Xin <worldhello.net AT gmail DOT com>
日期:        Sun Aug 23 23:53:05 2009 +0800
文件:        src/COPYRIGHT src/main.bak src/main.c
描述:
Fixed #6: import new upstream version hello-2.0.0

初始化一个Git版本库，该版本库就是迁移的目标版本库。

$ mkdir -p /path/to/my/workspace/hello
$ cd /path/to/my/workspace/hello
$ git init
Initialized empty Git repository in /path/to/my/workspace/hello/.git/

在刚刚完成初始化的Git工作区中调用hg-fast-export.sh脚本完成版本库转换。
```
$ /path/to/fast-export/hg-fast-export.sh -r /path/to/hg/hello
```
转换完毕，执行git branch会看到Hg版本库中的具名分支都转换为相应的分支，没有命名的缺省头指针转换为master分支。
```
$ git branch
* master
  next
  r1.x
```

在转换后的Git版本库目录中，保存了几个用于记录版本库转换进度的状态文件（.git/hg2git-*），当在Git工作区不带任何参数执行hg-fast-export.sh命令时，会继续增量式的进行转换，将Hg版本库中的新提交迁移到Git版本库中。

如果使用了多个不同的Hg克隆版本库进行分支管理，就需要一一对Hg版本库进行转换，然后在对转换后的Git版本库进行合并。在合并Git版本库的时候可以参考下面的命令。

$ git remote add <name1> <path/to/repos/1>
$ git remote add <name2> <path/to/repos/2>
$ git remote update
$ git checkout -b <branch1> origin/<name1>/master
$ git checkout -b <branch2> origin/<name2>/master