本教程旨在解决go语言开发中常见的`go get`命令报错“cannot download, $gopath not set”的问题。即使您已通过`gopath=...`设置了环境变量，该错误仍可能发生。核心原因是`gopath`变量未正确导出到子进程。文章将详细解释`export`命令的作用，并提供正确的`gopath`设置与导出方法，确保`go get`等go工具能正常工作，并指导如何进行持久化配置。
理解Go语言环境变量与go get
在Go语言开发中，GOPATH是一个至关重要的环境变量，它指定了Go工作区的位置。这个工作区通常包含三个子目录：
- src：存放项目源代码。
- pkg：存放编译后的包文件。
- bin：存放编译后的可执行文件。
go get命令用于下载并安装Go包及其依赖。当执行go get时，它会尝试将下载的包放置到$GOPATH/src目录下，并将其可执行文件（如果存在）安装到$GOPATH/bin。因此，go get命令需要能够访问并识别GOPATH的值。
常见的$GOPATH未设置错误分析
开发者在配置GOPATH时，可能会遇到一个看似矛盾的错误：即使通过echo $GOPATH命令确认GOPATH变量已设置，但执行go get时仍然收到“cannot download, $GOPATH not set”的错误信息。
$ echo $GOPATH /home/cyrus/.go # 看起来GOPATH已经设置了 $ go get code.google.com/p/go-tour/gotour package code.google.com/p/go-tour/gotour: cannot download, $GOPATH not set. For more details see: go help gopath
这个问题的根源在于环境变量的作用域。在Unix/Linux系统中，当你执行GOPATH=$HOME/go这样的命令时，你确实为当前shell进程设置了一个名为GOPATH的变量。然而，这个变量默认情况下仅对当前进程及其直接子进程可见，而不会自动传递给更深层的子进程或由当前进程启动的新进程（例如go get可能在内部启动的其他工具）。
立即学习“go语言免费学习笔记（深入）”；
为了让环境变量能够被所有子进程（包括go get命令所依赖的Go工具链）访问，你需要使用export命令将其“导出”。
正确设置与导出GOPATH
要确保GOPATH被Go工具正确识别，你需要明确地将其导出。以下是两种推荐的方法：
方法一：先设置，后导出
# 1. 设置GOPATH变量 GOPATH=$HOME/go # 2. 将GOPATH变量导出，使其对所有子进程可见 export GOPATH # 验证GOPATH是否已导出且可访问 echo $GOPATH
方法二：合并设置与导出
更简洁的方式是在设置变量的同时直接导出：
# 直接设置并导出GOPATH export GOPATH=$HOME/go # 验证GOPATH是否已导出且可访问 echo $GOPATH
示例代码： 假设你的Go工作区路径为/home/cyrus/.go，你可以这样设置和导出GOPATH：
# 确保工作区目录结构存在（如果不存在）
mkdir -p $HOME/.go/{src,pkg,bin}
# 设置并导出GOPATH
export GOPATH=$HOME/.go
# 验证GOPATH
echo $GOPATH
# 预期输出: /home/cyrus/.go
# 现在，尝试执行go get命令
go get code.google.com/p/go-tour/gotour
# 如果一切配置正确，此命令将成功执行使GOPATH配置持久化
上述的export命令只对当前shell会话有效。一旦关闭终端或打开新的终端窗口，GOPATH的设置就会丢失。为了避免每次都手动设置，你需要将export GOPATH=...命令添加到你的shell配置文件中。
常见的shell配置文件包括：
- Bash: ~/.bashrc 或 ~/.bash_profile
- Zsh: ~/.zshrc
- Fish: ~/.config/fish/config.fish
步骤：
-
编辑配置文件： 使用你喜欢的文本编辑器打开对应的shell配置文件。例如，对于Bash用户：
nano ~/.bashrc
-
添加配置行： 在文件的末尾添加以下行（请根据你的实际路径调整$HOME/.go）：
export GOPATH=$HOME/.go export PATH=$PATH:$GOPATH/bin # 推荐将GOPATH/bin添加到PATH，方便直接运行go get安装的工具
注意： 如果你使用的是Go Modules（Go 1.11+），并且项目在GOPATH之外，Go Modules会自动管理依赖，GOPATH的作用会减弱，但仍然影响一些全局工具和旧项目。对于Go Modules项目，通常不需要手动设置GOPATH，但将其添加到PATH仍然有益。
- 保存并退出。
-
刷新配置文件： 为了让更改立即生效，你需要重新加载配置文件：
source ~/.bashrc # 或 ~/.zshrc 等
或者直接打开一个新的终端窗口。
总结
go get命令报错“cannot download, $GOPATH not set”是一个常见的Go语言新手问题，其根本原因在于GOPATH环境变量未被正确导出到子进程。通过使用export命令，我们可以确保GOPATH在整个Go工具链中都可访问。为了提高开发效率，建议将GOPATH的设置和导出命令添加到shell配置文件中，使其在每次启动终端时自动加载。遵循这些步骤，将能有效解决GOPATH相关的配置问题，确保Go开发环境的顺畅运行。
