在go语言开发中，我们经常会遇到一个令人困惑的问题：项目在终端中能够正常编译和运行，但在集成开发环境（ide）或文本编辑器（如sublime text）的构建系统中却报错“cannot find package”。这通常不是代码逻辑错误，而是开发环境配置不一致所致，特别是环境变量的差异。
理解Go语言环境变量的重要性
Go语言的构建工具依赖于几个关键的环境变量来定位源代码、工具链和依赖包：
- GOPATH: 这是Go语言工作区（workspace）的路径。所有非标准库的Go包（包括第三方库和你自己编写的模块）都应该位于GOPATH下的src目录中。Go编译器会在此路径下查找导入的包。
- GOROOT: 这是Go语言安装的根目录，包含了Go的标准库和工具链。
- PATH: 操作系统用来查找可执行文件的路径列表。go命令本身就需要通过PATH变量来找到。
当你在终端中执行go run或go build时，你的Shell环境通常已经配置了正确的GOPATH、GOROOT和PATH。然而，许多编辑器或IDE的构建系统在执行外部命令时，并不会完全继承Shell的环境变量，它们可能运行在一个更加“干净”的环境中，导致Go工具链无法找到必要的路径信息。
诊断问题
当你看到类似test.go:5:2: import "newmath": cannot find package的错误时，即使go env显示GOPATH已正确设置，这强烈暗示Sublime Text的构建系统没有使用你期望的环境变量。
以下是一个典型的Sublime Text 2构建系统配置，它可能导致上述问题：
立即学习“go语言免费学习笔记（深入）”；
{
"cmd": ["go","run", "${file}"],
"working_dir": "${file_path}",
"selector": "source.go, source.g"
}这个配置仅指定了执行go run命令、工作目录和文件类型选择器，但它没有告诉Sublime Text go命令在哪里，以及GOPATH和GOROOT在哪里。
解决方案：显式配置构建系统环境变量
解决此问题的核心方法是在Sublime Text的构建系统配置中，显式地设置PATH和env变量，以确保go工具链能够找到自身以及所有Go包。
以下是修改后的Sublime Text 2构建系统配置示例：
{
"cmd": ["go","run", "${file}"],
"working_dir": "${file_path}",
"selector": "source.go, source.g",
"path": "/usr/lib/go/bin:$PATH",
"env": {
"GOPATH": "/home/daggi/gocode/",
"GOROOT": "/usr/lib/go",
"PATH": "/usr/lib/go/bin:$PATH"
}
}配置详解：
- "cmd": ["go","run", "${file}"]: 这指定了要执行的命令。go run用于编译并运行Go源文件。
- "working_dir": "${file_path}": 设置命令的执行目录为当前打开文件的路径，这对于相对路径的导入很有用。
- "selector": "source.go, source.g": 告诉Sublime Text这个构建系统适用于.go文件。
- "path": "/usr/lib/go/bin:$PATH": 这个path属性是Sublime Text构建系统特有的，它会预置到执行命令的环境PATH变量中。在这里，我们确保Go可执行文件（go命令）所在的目录（通常是/usr/lib/go/bin或/usr/local/go/bin，根据你的Go安装路径而定）被包含在PATH中。$PATH会引用系统原有的PATH变量。
- "env": { ... }: 这个env属性允许你为构建命令设置一组特定的环境变量。
- "GOPATH": "/home/daggi/gocode/": 将GOPATH显式设置为你的Go工作区路径。请务必将其替换为你的实际GOPATH。
- "GOROOT": "/usr/lib/go": 将GOROOT显式设置为你的Go安装根目录。同样，请根据你的实际安装路径进行调整。
- "PATH": "/usr/lib/go/bin:$PATH": 在env中再次设置PATH，这确保了go命令在执行时的完整PATH。这里的$PATH会引用Sublime Text构建系统启动时的PATH（可能已经包含了上面path属性设置的值）。通常，在env中设置PATH会更可靠，因为它直接影响命令执行的环境。
注意事项：
- 路径准确性： 务必将示例中的/home/daggi/gocode/和/usr/lib/go替换为你系统中实际的GOPATH和GOROOT路径。你可以通过在终端中运行go env GOPATH和go env GOROOT来获取这些信息。
- 用户主目录变量： 在GOPATH中，你可以使用${HOME}或$HOME来代表用户主目录，例如"GOPATH": "$HOME/gocode/"，这使得配置更具可移植性。
- 项目级GOPATH： 如果你的Sublime Text项目目录结构恰好与GOPATH要求一致（即项目根目录就是GOPATH），你也可以考虑使用${project_path}变量来动态设置GOPATH，例如"GOPATH": "${project_path}"。但这需要你的项目布局非常规范，即项目根目录下包含src、pkg、bin目录。
总结
通过在Sublime Text的构建系统中明确配置GOPATH、GOROOT和PATH环境变量，我们可以有效解决Go语言包导入失败的问题。这确保了Sublime Text的构建环境与你的Shell环境一致，使得Go编译器能够正确地找到所有必需的包和工具。对于任何IDE或编辑器，当遇到类似的环境变量问题时，检查并显式配置其构建环境是解决此类问题的通用方法。养成在开发环境中统一管理环境变量的习惯，能够显著提升开发效率和减少不必要的配置困扰。
