必须手动指定goroot并重启goland，否则运行按钮灰掉、import标红、test图标不出现；goroot须指向go安装根目录（含src/pkg/bin），不可为bin子目录，且需配置go modules代理为https://goproxy.cn,direct并删除go.work文件。
新电脑装完 GoLand 后，main.go 右上角运行按钮灰掉、import 标红、go test 图标不出现——不是 IDE 有问题，而是它根本没连上你本地的 go 命令。必须手动指定 GOROOT 并重启，否则所有功能都只是摆设。
确认系统级 Go 已安装且可用
GoLand 不自带 Go 编译器，它完全依赖你系统 PATH 里的 go。别跳过这步直接开 IDE：
- 打开终端（CMD/PowerShell/Terminal），执行
go version；无输出或报“不是内部或外部命令”，说明 Go 没装好或没进 PATH - Windows 用 MSI 安装默认写入
C:\Go\bin到系统 PATH；若自定义路径（如D:\Go），需手动把D:\Go\bin加进环境变量 - macOS/Linux 检查
echo $PATH是否含/usr/local/go/bin；若无，编辑~/.zshrc追加export PATH=$PATH:/usr/local/go/bin，然后关掉所有终端重开 -
go env GOROOT输出应为实际安装根目录（如C:\Go或/usr/local/go），且该路径下必须有src、pkg、bin三个文件夹
在 GoLand 中手动绑定 GOROOT 并重启
GoLand 不继承系统 PATH，也不会自动探测 go。它只认你明确指定的 GOROOT 路径，且必须重启生效：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- Settings → Go → GOROOT → 点击右侧文件夹图标，选择你
go env GOROOT输出的完整路径（不是子目录，例如不能选C:\Go\bin） - 删掉输入框里可能自动填充的
/bin/go后缀，确保路径结尾是C:\Go或/usr/local/go - 点 Apply → 关闭 GoLand → 完全退出进程（任务管理器里确认没有残留
goland64.exe或jetbrains-go进程）→ 重新启动 - 验证：新建项目 → 写
package main; import "fmt"; func main() { fmt.Println("ok") }；若fmt不标红、右上角绿色三角亮起，说明绑定成功
启用 Go Modules 并配对代理
不启用模块模式，go get 会走旧 GOPATH 逻辑，go.mod 不生成，依赖全乱套：
- Settings → Go → Go Modules → 勾选
Enable Go modules integration -
Proxy栏填完整值：https://goproxy.cn,direct（注意逗号后有空格，direct不能省，否则私有包或新版包会 404） - 删除项目根目录下可能存在的
go.work文件（它会强制多模块模式，干扰单模块项目初始化） - 右键项目根目录 →
Reload project（不是Sync）；此时go.mod应自动生成，vendor目录（如有）也会被识别
检查项目路径与工具链是否干净
路径含中文、空格、符号，或 dlv/gopls 缺失，都会导致运行/调试失败：
- 项目路径必须全英文、无空格、无特殊字符（如
C:\Users\name\go\src\hello可，~/Desktop/我的项目不可） - 终端执行
go install golang.org/x/tools/gopls@latest安装语言服务器；完成后运行gopls version应有输出 - GoLand 的 Terminal 设置（Settings → Tools → Terminal）要和你系统终端一致（如 macOS 用 zsh，这里也选 zsh），否则 PATH 不同步
- 首次打开项目时，IDE 弹出 “Some tools are missing” 提示，点
Install装全dlv、golint等；dlv version应能输出版本号
最常被忽略的是：GOROOT 指定后不重启 IDE，或者代理只填了 https://goproxy.cn 却漏掉 ,direct。这两处一错，整个环境就卡在“能打开但跑不起来”的状态，反复折腾半天才发现是配置项少敲了几个字符。
