解决 Go Get 获取 Mercurial 仓库包时 ’hg’ 未找到的问题

作者 2025年10月13日 6

本文详细阐述了在使用 `go get` 命令获取基于 mercurial (hg) 版本控制系统的 go 语言包时，遇到 ‘exec: “hg”: executable file not found in %path%’ 错误的解决方案。核心在于需要安装 mercurial 客户端并确保其可执行文件路径已添加到系统环境变量 path 中，从而使 `go get` 能够调用 `hg` 命令来克隆远程仓库。

理解 Go Get 与版本控制系统

Go 语言的 go get 命令是一个极其方便的工具，用于自动下载、编译并安装远程 Go 语言包及其依赖项。它的工作原理是根据包的导入路径（例如 github.com/user/repo 或 code.google.com/p/go.example）自动识别其所使用的版本控制系统（VCS），然后调用相应的 VCS 客户端工具（如 git、Mercurial、svn 等）来克隆远程仓库。

当 go get 尝试获取一个包时，它会执行以下步骤：

解析包路径，确定其托管平台和版本控制类型。
调用相应的 VCS 客户端命令（例如 git clone 或 hg clone）将远程仓库克隆到本地 $GOPATH/src 目录下。
在本地 $GOPATH/src 目录下编译并安装包。

诊断 ‘hg’ 未找到的错误

在尝试获取 code.google.com/p/go.example/hello 这类包时，如果遇到以下错误信息：

package code.google.com/p/go.example/hello: exec: "hg": executable file not found in %PATH%

这明确指示了问题所在：go get 尝试调用 hg 命令，但系统无法找到名为 hg 的可执行文件。code.google.com/p/go.example 是一个托管在 Google Code 上的项目，它使用的是 Mercurial (hg) 版本控制系统。因此，为了成功获取这个包，您的系统必须安装 Mercurial 客户端，并且其可执行文件路径必须包含在系统环境变量 PATH 中。

即使您的 GOPATH 和 GOROOT 配置正确，且其他基于 Git 的包能够正常获取，只要遇到基于 Mercurial 的包，缺少 hg 客户端就会导致上述错误。

解决方案：安装 Mercurial 并配置 PATH

解决此问题的核心步骤是安装 Mercurial 客户端，并确保其可执行文件在系统 PATH 环境变量中可被找到。

1. 安装 Mercurial

Mercurial 可以在多种操作系统上安装。以下是常见操作系统的安装方法：

windows: 访问 Mercurial 官方网站 https://www.php.cn/link/61f3024ed641390e498517b310f7a378 下载最新的 Windows 安装程序。运行安装程序并按照指示完成安装。在安装过程中，通常会有一个选项询问是否将 Mercurial 添加到系统 PATH 中，请务必勾选此选项。
macOS: 如果您使用 Homebrew，可以通过以下命令安装：
```
brew install mercurial
```
如果没有 Homebrew，可以从官方网站下载安装包。

linux (debian/ubuntu):

sudo apt update sudo apt install mercurial

Linux (Fedora):

包阅AI

论文对照翻译，改写润色，专业术语详解，选题评估，开题报告分析，评审校对，一站式解决论文烦恼！

84

查看详情
```
sudo dnf install mercurial
```
Linux (centos/RHEL):
```
sudo yum install mercurial
```

安装完成后，打开一个新的终端或命令提示符窗口（确保环境变量已刷新），输入 hg version 命令验证 Mercurial 是否成功安装并可在 PATH 中找到。如果显示 Mercurial 的版本信息，则表示安装成功。

hg version

如果仍然提示 command not found 或类似错误，则需要手动检查并配置 PATH 环境变量。

2. 配置系统 PATH 环境变量

通常，Mercurial 的安装程序会自动将其可执行文件路径添加到 PATH 中。如果未自动添加，或者您选择手动安装，则需要手动配置。

Windows:
1. 右键点击“此电脑”或“我的电脑”，选择“属性”。
2. 点击“高级系统设置”。
3. 在“系统属性”对话框中，点击“环境变量”按钮。
4. 在“系统变量”部分找到名为 Path 的变量，双击编辑。
5. 点击“新建”，然后添加 Mercurial 安装目录下的 bin 文件夹路径（例如：C:Program FilesMercurialbin 或 C:Program Files (x86)Mercurialbin）。
6. 点击“确定”保存所有更改。
7. 关闭所有命令提示符窗口，然后重新打开一个，再次运行 hg version 进行验证。
macOS/Linux: Mercurial 通常安装在 /usr/local/bin 或 /usr/bin 等标准路径下，这些路径通常已包含在系统 PATH 中。如果不是，您可以编辑您的 shell 配置文件（例如 ~/.bashrc, ~/.zshrc, ~/.profile），添加以下行：
```
export PATH="/path/to/mercurial/bin:$PATH"
```
将 /path/to/mercurial/bin 替换为 Mercurial 可执行文件的实际路径。保存文件后，运行 source ~/.bashrc (或相应的配置文件) 使更改生效，然后验证 hg version。

重新执行 go get

在确认 Mercurial 客户端已正确安装且其路径已添加到系统 PATH 环境变量之后，您可以再次尝试运行 go get 命令来获取远程包：

go get code.google.com/p/go.example/hello

此时，go get 将能够成功调用 hg 命令来克隆 code.google.com/p/go.example 仓库，并将 hello 包及其依赖项下载到您的 $GOPATH/src 目录中。

注意事项与总结

版本控制工具的依赖性： go get 对外部版本控制工具的依赖性是其设计的一部分。遇到类似错误时，首先要检查是否缺少相应的 VCS 客户端。对于 Git 仓库，需要安装 Git；对于 Subversion 仓库，需要安装 SVN 客户端。
PATH 环境变量的重要性： 确保所有命令行工具的可执行文件路径都已正确添加到系统的 PATH 环境变量中，是开发环境中一个常见的配置要求。
刷新环境变量： 在修改环境变量后，通常需要关闭并重新打开终端或命令提示符窗口，或者在当前会话中运行 source 命令（Linux/macos）来使更改生效。
Go Modules 模式： 对于 Go 1.11 及更高版本，推荐使用 Go Modules 进行依赖管理。在模块模式下，go get 的行为有所不同，但对于获取远程仓库的基本需求（如调用 VCS 客户端）仍然相同。

通过理解 go get 的工作机制并确保所需的版本控制工具已正确安装并配置在系统 PATH 中，可以有效解决在获取远程 Go 语言包时遇到的类似问题。

Hello! 欢迎来到悠悠畅享网！