本文详细阐述了在使用 `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):
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:
- 右键点击“此电脑”或“我的电脑”，选择“属性”。
- 点击“高级系统设置”。
- 在“系统属性”对话框中，点击“环境变量”按钮。
- 在“系统变量”部分找到名为 Path 的变量，双击编辑。
- 点击“新建”，然后添加 Mercurial 安装目录下的 bin 文件夹路径（例如：C:\Program Files\Mercurial\bin 或 C:\Program Files (x86)\Mercurial\bin）。
- 点击“确定”保存所有更改。
- 关闭所有命令提示符窗口，然后重新打开一个，再次运行 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 语言包时遇到的类似问题。
