Go命令找不到、go run报错、go install二进制不可用，90%是环境配置错误：需确保which go与go env GOROOT路径一致，$GOPATH/bin在PATH中，且GoLand的GOROOT设置必须严格匹配go env GOROOT输出值。
go 命令找不到、go run 报 cannot find package、go install 编译出的二进制在终端里用不了——这些问题 90% 不是代码写错了，而是环境没搭对。GoLand 本身不解决环境问题，它只是暴露了你本地 Go 工具链的真实状态。所谓“推荐的 GoLand 搭建方法”，本质是**用 IDE 反向验证并固化一套干净、可复现的 Go 环境配置**。
为什么 go 在终端能跑，但在 GoLand 里提示 “No SDK found”
GoLand 启动时会主动扫描 GOROOT，但它不读取 shell 的 PATH 或 ~/.zshrc 里的动态 export；它只认你手动指定的绝对路径（比如 /usr/local/go），或系统级环境变量（如 Windows 的系统变量、macOS/Linux 的 /etc/environment）。常见现象：
-
which go输出/usr/local/go/bin/go，但 GoLand 配置界面里填/usr/local/go才能识别 —— 它要的是GOROOT，不是go可执行文件路径 - 你用
brew install go，实际安装路径是/opt/homebrew/opt/go/libexec，填错成/opt/homebrew/bin就会失败 - Mac 上用了 zsh，但 GoLand 启动自 Shell（如通过 Spotlight 或 Dock），它根本没加载
~/.zshrc，导致GOROOT和GOPATH全部失效
go env GOPATH 和 GoLand 里设置的 “Project GOPATH” 是两回事
GoLand 的 “Project GOPATH” 是旧版 UI 里遗留的选项，仅影响某些老插件行为；现代项目完全由 go.mod 决定模块根目录，GOPATH 只控制 go install 输出位置。关键点：
- 运行
go env GOPATH查到的是当前生效值，默认是$HOME/go；如果想改，必须用go env -w GOPATH=/opt/go，而不是只改临时 shell 变量 -
go install .生成的二进制一定落在$GOPATH/bin，所以这个目录必须在系统PATH里，否则终端也调用不到 - GoLand 的 “Terminal” 标签页默认继承 shell 环境，但 “Run” 和 “Debug” 是独立进程，只认
GOROOT+go env输出的值
为什么建议官网 .tar.gz 而非 brew/choco
包管理器安装看似方便，但升级/卸载时容易残留冲突路径，尤其对 GoLand 这类依赖明确 GOROOT 的工具很不友好：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
-
brew upgrade go可能把新版本装到/opt/homebrew/Cellar/go/1.22.5，再软链到/opt/homebrew/opt/go/libexec，而旧版本残留的/usr/local/go还在PATH里 - GoLand 配置里填了
/usr/local/go，结果go version显示 1.20，但终端里which go指向的是 1.22 —— 工具链和 IDE 认的不是同一个东西 - 官网
.tar.gz解压到/usr/local/go是静态路径，重装时删目录再解压即可，没有符号链接、Cellar 子目录等中间层干扰
真正该盯住的三个检查点
别信“一键配置”，每台机器都要亲手确认这三项：
- 终端里运行
which go和go env GOROOT，输出路径必须一致，且指向真实安装目录（不是 bin 子目录） - 新开一个终端窗口，执行
go install hello@latest，然后直接敲hello能运行 —— 说明$GOPATH/bin确实在PATH里 - GoLand 中 File → Settings → Go → GOROOT，必须填
go env GOROOT的输出值，不能靠猜或复制which go的结果
环境变量不是写进去就生效，IDE 不是 reload 一下配置就能同步 shell 状态。最常被忽略的，是 GoLand 启动方式 —— 从终端用 goland . 启动，它才真继承当前 shell 环境；双击图标启动，就是另一套变量体系。
