本文旨在解决go语言开发中，使用`go get`命令获取基于mercurial版本控制系统的远程包时，出现的“exec: "hg": executable file not found in %path%”错误。核心解决方案是安装mercurial客户端，并确保其可执行文件路径已添加到系统环境变量path中，从而允许`go get`工具正确调用相应的版本控制命令来克隆远程代码库。
理解go get的工作原理
go get是Go语言中一个强大的包管理命令，其主要功能是自动下载、编译和安装远程Go包及其依赖。它的智能之处在于，会根据包的导入路径自动识别其托管的版本控制系统（VCS）。例如，对于托管在GitHub上的包，go get会尝试使用Git客户端；对于一些早期或特定平台（如历史上的Google Code项目）托管的包，可能使用Mercurial（hg）或Subversion（svn）。
一旦go get识别出目标包所使用的VCS，它就会尝试调用相应的VCS客户端命令（如git clone、hg clone或svn checkout）来克隆或更新远程代码库到本地的GOPATH或模块缓存目录。随后，它会编译并安装这些包。
“hg”可执行文件未找到错误解析
当go get尝试获取一个托管在Mercurial上的包时，例如导入路径为code.google.com/p/go.example/hello的包，它会期望在系统环境中找到Mercurial客户端的可执行文件，即hg命令。如果系统没有安装Mercurial，或者Mercurial已经安装但其可执行文件所在的路径没有被添加到系统的PATH环境变量中，go get就无法找到并执行hg命令，从而导致以下错误：
# cd .; hg clone -U https://code.google.com/p/go.example C:\sbox\go\example\src\code.google.com\p\go.example package code.google.com/p/go.example/hello: exec: "hg": executable file not found in %PATH%
这个错误信息清晰地表明，go get尝试执行hg clone命令，但操作系统在PATH环境变量指定的目录中找不到名为hg的可执行程序。这阻碍了包的下载过程，导致go get操作失败。
立即学习“go语言免费学习笔记（深入）”；
解决方案：安装并配置Mercurial
解决此问题的核心在于确保Mercurial客户端已正确安装，并且其可执行文件路径已添加到系统的PATH环境变量中。
步骤一：安装Mercurial
访问官方网站： 前往Mercurial的官方网站 https://www.mercurial-scm.org/。
-
下载安装包： 根据您的操作系统（Windows, macOS, Linux）下载相应的安装包或遵循安装指南。
Windows: 通常提供一个图形化安装程序（.exe文件），按照向导提示进行安装。
-
macOS: 可以使用Homebrew进行安装：
brew install mercurial
-
Linux: 大多数发行版可以通过其包管理器安装：
# Debian/Ubuntu sudo apt-get install mercurial # Fedora sudo dnf install mercurial # CentOS/RHEL sudo yum install mercurial
完成安装后，请确保安装程序已将Mercurial的可执行文件路径添加到系统的PATH环境变量中。如果未自动添加，则需要手动执行下一步。
步骤二：验证Mercurial安装及PATH配置
安装Mercurial后，需要验证其是否可被系统识别。
打开新的命令行/终端： 确保打开一个新的命令行或终端窗口，以便刷新环境变量。
-
执行hg version命令：
hg version
如果Mercurial安装成功且其路径已正确配置到PATH中，您将看到Mercurial的版本信息。例如：
Mercurial Distributed SCM (version 6.5.2) (see https://mercurial-scm.org for more information) Copyright (C) 2005-2023 Matt Mackall et al. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-
手动配置PATH（如果需要）： 如果hg version仍然提示“hg”命令未找到，则需要手动将Mercurial的安装目录（通常是包含hg.exe或hg可执行文件的bin目录）添加到系统的PATH环境变量中。
-
Windows:
- 右键点击“此电脑”或“我的电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
- 在“系统变量”部分找到名为“Path”的变量，点击“编辑”。
- 添加Mercurial的bin目录路径（例如：C:\Program Files\Mercurial\bin），确保与其他路径用分号隔开。
- 点击“确定”保存所有更改。
-
Linux/macOS:
- 编辑您的shell配置文件（例如，对于Bash是~/.bashrc或~/.bash_profile，对于Zsh是~/.zshrc）。
- 在文件末尾添加一行：
export PATH=$PATH:/path/to/mercurial/bin
将/path/to/mercurial/bin替换为Mercurial实际的bin目录路径。
- 保存文件后，执行 source ~/.bashrc (或相应文件) 使更改生效。
-
Windows:
步骤三：重新执行go get命令
在Mercurial安装并PATH配置正确后，再次运行go get命令：
go get code.google.com/p/go.example/hello
此时，go get应该能够成功调用hg命令，从远程仓库克隆代码，并将其放置在GOPATH或Go模块缓存的相应目录中，完成包的下载和安装。
注意事项与最佳实践
- VCS工具的普遍性： go get对多种VCS工具都有依赖。除了Mercurial，最常用的是Git。如果您需要从GitHub、GitLab、Bitbucket等平台获取包，务必安装Git并确保其在PATH中。
- Go Modules： 在Go 1.11及更高版本中，Go Modules是推荐的包管理方式。当使用Go Modules时，包会被下载到模块缓存（GOPATH/pkg/mod）中，而不是直接到GOPATH/src。但无论是否使用Go Modules，go get对VCS客户端的依赖性不变。
- GOPATH的重要性： 尽管Go Modules减少了对GOPATH的直接依赖，但在传统模式下，go get会将下载的包存储在GOPATH环境变量指定的路径下。确保GOPATH已正确设置，并且您的项目结构遵循Go的工作区约定。
- 网络连接： 确保您的开发环境具有稳定的网络连接，以便go get能够访问远程仓库。
- 代理设置： 如果您处于需要代理的网络环境中，请确保Go命令能够通过代理访问外部网络。可以设置HTTP_PROXY和HTTPS_PROXY环境变量。
总结
go get命令是Go语言生态系统中管理外部依赖的关键工具，它简化了远程包的获取和集成。然而，其正常运行依赖于系统中安装的、与远程仓库VCS类型相匹配的客户端工具。当遇到“exec: "hg": executable file not found in %PATH%”错误时，核心在于识别出目标包使用Mercurial，然后安装Mercurial客户端并正确配置其环境变量。理解go get背后的机制，能够帮助开发者更有效地诊断和解决因环境配置或VCS工具缺失导致的各类包管理问题。
