导入 Mercurial 存储库

先决条件

若要执行这些步骤，必须使用 macOS 或 Linux 系统并安装以下工具：

Mercurial
Git
Git Large File Storage (Git LFS)（请参阅“安装 Git Large File Storage”）
Python，包括 pip 包管理器

导入 Mercurial 存储库

在你的 GitHub Enterprise Server 实例上创建一个新存储库。为避免错误，请勿使用 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，然后重试。

导入 Mercurial 存储库

本文内容

先决条件

导入 Mercurial 存储库