先决条件
若要执行这些步骤,必须使用 macOS 或 Linux 系统并安装以下工具:
- Mercurial
- Git
- Git Large File Storage (Git LFS)(请参阅“安装 Git Large File Storage”)
- Python,包括
pip
包管理器
导入 Mercurial 存储库
-
在 GitHub 上创建新存储库。 为避免错误,请勿使用 README、许可或 gitignore 文件初始化新存储库。 您可以在项目推送到 GitHub Enterprise Server 之后添加这些文件。 有关详细信息,请参阅“创建新仓库”。
-
若要确认计算机上已安装 Mercurial,请运行
hg --version
。输出应类似于
Mercurial Distributed SCM (version 6.4)
。 -
若要确认计算机上已安装 Git,请运行
git --version.
输出应类似于
git version 2.40.0
。 -
若要确认计算机上已安装 Git LFS,请运行
git lfs --version
。输出应类似于
git-lfs/3.1.4 (GitHub; darwin arm64; go 1.18.1)
。 -
若要确认计算机上已安装
pip
,请运行pip --version
。输出应类似于
pip 21.2.4
。 -
若要安装
mercurial
Python 包,请运行pip install mercurial
。 -
将最新版本的 fast-export 下载到计算机,然后解压缩存档。
-
移动到解压缩的目录中,然后运行
./hg-fast-export.sh --help
。输出的开头应为
usage: hg-fast-export.sh
。 -
克隆 Mercurial 存储库。
例如,若要将 Mercurial 本身的源代码克隆到
mercurial-repo
目录,请运行hg clone https://www.mercurial-scm.org/repo/hg mercurial-repo
。 -
创建新目录,移动到新目录,然后初始化新的 Git 存储库。
例如,如果要将新存储库命名为
mercurial-git
,请运行mkdir mercurial-git && cd mercurial-git && git init
。 -
移动到新创建的 Git 存储库的目录中。
-
若要将新的 Git 存储库配置为以与 Mercurial 相同的方式处理文件名大小写,请运行
git config core.ignoreCase false
。 -
若要获取 Mercurial 项目中的提交者列表并将该列表存储在
committers.txt
中,请运行以下脚本。Shell hg log --template "{author}\n" | sort | uniq > committers.txt
hg log --template "{author}\n" | sort | uniq > committers.txt
-
更新
committers.txt
文件,将 Mercurial 存储库中使用的提交者姓名映射到要在 Git 存储库中使用的姓名,格式如下:“The Octocat <octocato@gmail.com>”=”Octocat <octocat@github.com>”
-
在初始化的 Git 存储库中,运行
hg-fast-export.sh
,传入 Mercurial 存储库的路径和committers.txt
文件的路径作为参数。例如,
../fast-export-221024/hg-fast-export.sh -r ../mercurial-repo -A ../mercurial-repo/committers.txt -M main
。 -
导入完成后,若要检查新创建的 Git 存储库,请运行
git checkout HEAD
。 -
若要将 GitHub 存储库添加为远程存储库,请运行
git remote add origin URL
,将URL
替换为前面创建的 GitHub 存储库的 URL,例如https://github.com/octocat/example-repository.git
。 -
若要将存储库推送到 GitHub,请运行
git push --mirror origin
。如果存储库包含的任何文件大于 GitHub Enterprise Server 的文件大小限制,则你的推送可能会失败。 通过运行
git lfs import
将大文件移动到 Git LFS,然后重试。