GoLand启动前必须确认go命令可用，即终端执行go version有输出；GOROOT须手动设为Go安装根目录（如/usr/local/go），GOPATH非必需但GOBIN需配置，且IDE须通过终端启动以继承shell环境。
GoLand 启动前必须确认 go 命令可用
GoLand 本身不带 Go 编译器，它完全依赖你本地的 go 二进制。如果终端里执行 go version 报 “command not found”，GoLand 就会卡在 “No SDK found” 或直接拒绝创建项目。
- Windows 用户装完官方
.msi后，PATH 通常已自动配置；但若用 zip 解压方式安装，必须手动把C:\Go\bin加入系统 PATH - macOS 用户用 Homebrew 安装后，
go默认在/opt/homebrew/bin/go（Apple Silicon）或/usr/local/bin/go（Intel），需确认 shell 配置文件（如~/.zshrc）里有对应路径 - Linux 用户解压到
/usr/local/go后，别漏掉export PATH=$PATH:/usr/local/go/bin - 验证方式不是只看 GUI 界面提示，而是打开终端，新开一个 tab，再跑一次
go version—— 很多人改了配置但没重开终端，导致 IDE 读不到新 PATH
GOROOT 和 GOPATH 在 GoLand 里要不要设？
Go 1.16+ 默认启用模块（module）模式，GOPATH 不再是项目存放必需路径，但 GOROOT 必须准确指向 Go 安装根目录，否则 GoLand 无法调用 go list -mod=mod -f {{.Dir}} 这类底层命令，索引会失败、跳转失效。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
-
GOROOT：GoLand 2025 通常能自动探测（比如 macOS 上识别/usr/local/go），但如果它探测成/opt/homebrew/Cellar/go/1.22.5/libexec这种 Homebrew Cellar 路径，就得手动改成/opt/homebrew/opt/go（符号链接所在位置） -
GOBIN：虽不在 GoLand 设置界面里显式出现，但它影响gopls、dlv是否能被 IDE 找到。建议在 shell 配置中显式设置GOBIN=$HOME/go/bin并加入 PATH -
GOPATH：现在可以不设，但如果你用go install装工具（如gopls），且没设GOBIN，Go 就会默认往$GOPATH/bin放，而这个路径若没加进 PATH，GoLand 就找不到它们
gopls 必须用 go install 装，不能靠 IDE 自动下载
GoLand 2025 默认尝试用内置逻辑拉取 gopls，但国内网络下大概率超时或校验失败，报错信息通常是 “Failed to start language server” 或 “gopls: command not found”。这不是插件问题，是路径和版本不匹配。
- 运行
go install golang.org/x/tools/gopls@latest（注意末尾@latest），它会把二进制放到$GOBIN/gopls或$GOPATH/bin/gopls - 装完立刻验证：
gopls version输出里的version字段应与go version主版本一致（如都是1.24.x），否则类型推导、泛型约束提示会失效 - GoLand 设置里进入
Settings → Languages & Frameworks → Go → Go Tools，勾选 “Use custom gopls binary”，然后点浏览指向你刚装好的gopls路径 - 别用
brew install gopls或从 GitHub Release 页面手动下载二进制——它们可能滞后于当前 Go 版本，或缺少 CGO 支持（尤其 macOS 上调试时崩溃）
调试器 dlv 和分析工具得提前装进 $GOBIN
GoLand 的调试窗口点击 “Debug” 按钮后黑屏、断点不生效，90% 是因为 dlv 没装，或装了但不在 PATH 里。同理，pprof 分析按钮灰掉，往往是因为没装 benchstat 或 dlv 版本太旧。
- 装调试器：
go install github.com/go-delve/delve/cmd/dlv@latest，macOS 上首次运行需在“系统设置 > 隐私与安全性 > 完全磁盘访问”里授权 - 装基准测试对比工具：
go install golang.org/x/perf/cmd/benchstat@latest（名字是benchstat，不是go-benchstat） - 验证是否就位：
which dlv和which benchstat必须返回非空路径；如果返回空，说明$GOBIN没进 PATH，或装的时候用了错误的 shell 环境 - GoLand 里不需要额外配置路径，只要终端能调用，IDE 就能继承——前提是启动 GoLand 的方式是通过终端（如
goland .），而不是桌面图标双击（后者不加载 shell 配置）
~/.zshrc 里加了 export PATH，却用鼠标双击图标启动 GoLand，结果 IDE 根本看不到这些变量。最稳的方式是：改完 shell 配置后，关掉所有终端，重新打开一个，运行 goland . 启动 IDE。 
