goland 必须配置本地 go sdk 才能正常使用，需确保终端可执行 go version、sdk 路径为包含 src/pkg/bin 的根目录（非 bin 子目录）、并正确设置 goproxy 代理，否则项目无法识别标准库和模块。

GoLand 能直接写 Go 代码，但装完不配置 SDK 就等于没装——它根本识别不了 go 命令，新建项目会卡在“Select Go SDK”这一步。

确认本地已安装 Go 并能被终端识别

GoLand 不自带 Go 编译器，它只是个编辑器，必须依赖系统已安装的 go。常见错误是：下载了 Go 安装包但没配 GOPATH 或 PATH，导致终端敲 go version 报 command not found。

• 在终端运行 go version，必须返回类似 go version go1.22.3 darwin/arm64 的结果
• 如果失败，先检查 go 是否在 PATH 中：which go（macOS/Linux）或 where go（Windows）
• Windows 用户尤其注意：MSI 安装器默认勾选“Add to PATH”，但 ZIP 解压版不会自动添加，需手动把 go\bin 目录加进系统环境变量

在 GoLand 中绑定已安装的 Go SDK

新建项目或打开空目录后，GoLand 会弹窗提示 “No SDK configured”。它要的不是下载链接，而是你本地 go 可执行文件所在目录的上一级路径（即 Go 安装根目录）。

GoLand 2026.1.1

GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。

下载

• macOS/Linux：SDK 路径通常是 /usr/local/go（Homebrew 安装则可能是 /opt/homebrew/Cellar/go/1.22.3/libexec）
• Windows：一般是 C:\Go（MSI 安装）或你解压的任意位置（如 D:\go）
• 别选错成 go/bin 目录——那是放可执行文件的，SDK 路径必须是包含 src、pkg、bin 三个子目录的父目录
• 配完后点 OK，GoLand 会自动检测版本并加载标准库索引，稍等几秒，状态栏右下角应显示 Go 1.22.3

验证 GOPROXY 和模块初始化是否生效

SDK 配对只是第一步。如果你用的是 Go 1.11+，且项目启用 Go Modules（默认开启），go mod download 会失败，除非代理可用——GoLand 不会自动帮你设 GOPROXY。

• 打开 File → Settings → Go → GOPATH（Windows/Linux）或 GoLand → Preferences → Go → GOPATH（macOS）
• 在 Go Proxy 输入框填入 https://proxy.golang.org,direct（国内用户建议换为 https://goproxy.cn,direct）
• 新建一个空目录，在终端里 go mod init example.com/hello，再在 GoLand 里打开该目录——此时应能正确解析 fmt 等标准包，且 go.mod 文件图标带 Go 标志
• 如果 still 显示 “Unresolved reference”，右键项目 → Reload project，而不是重启 IDE

真正卡住人的从来不是“三步”，而是每步里那个看似无关紧要的路径层级、环境变量作用域、或代理协议逗号分隔符；这些细节一旦错位，GoLand 就只会安静地显示灰色的 func main()，不报错，也不运行。