GoLand 2026.1.x 能运行取决于三件事:终端 go version 有输出、GOROOT 手动设为含 src/pkg/bin 的根目录并完全重启 IDE、新建项目必须选 Go module 模式且生成 go.mod;缺一即运行按钮灰显。

GoLand 最新版(2026.1.x)能跑起来,不靠“下一步点完就完事”,而取决于三件事是否做对:终端里 go version 有输出、GOROOT 手动指向正确路径并重启 IDE、新建项目时选的是 Go module 模式。漏掉任何一项,右上角运行按钮永远灰着。
go 命令在终端可用,但 GoLand 报 “No Go SDK found”
这是最常卡住新手的第一步。GoLand 不继承系统 PATH,也不信任自动探测——它只认你填进设置里的那个路径,而且必须是 Go 安装根目录(比如 C:\Go 或 /usr/local/go),不是 bin 子目录。
-
GOROOT路径下必须包含src、pkg、bin三个文件夹;如果只看到bin/go,说明你选错了 - Windows 用户若自定义安装到
D:\Go,需手动把D:\Go\bin加进系统环境变量PATH,加完必须关掉所有终端再重开 - macOS 用户用 Homebrew 安装的 Go,
GOROOT通常是/opt/homebrew/opt/go/libexec,不是/usr/local/bin/go - Settings → Go → GOROOT → 点右侧文件夹图标选择,别手输;点 Apply 后,必须完全退出 GoLand(包括后台进程),再重新启动
新建项目后 import 标红、go run 报错或超时
根本原因不是网络差,而是模块没启用或代理配置不完整。GoLand 2025+ 对非模块项目支持极弱,且默认不走 GO111MODULE=on。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 新建项目时,左侧选
Go,右侧模式务必选Go module,模块名填类似example.com/hello(不能纯数字或含空格) - 创建后立刻检查根目录是否有
go.mod;没有就删掉项目重来,别手动go mod init - Settings → Go → Go Modules → 勾选
Enable Go modules integration -
GOPROXY必须设为https://goproxy.cn,direct—— 缺少,direct会导致私有包、replace、刚发布的包全部失败 - 终端执行
go env GO111MODULE,如果不是on,运行go env -w GO111MODULE=on
运行按钮灰掉、main.go 点不了绿色三角
不是代码问题,是 GoLand 不知道该用什么路径执行 go run。它默认按模块路径解析,但入口位置和工作目录没对齐。
- 点击 main.go 旁的绿色三角前,先点右上角下拉箭头 →
Edit Configurations… - Working directory 设为
$FileDir$,这样点哪个main.go就以它所在目录为起点执行 - 或者统一用模块路径:Program arguments 填
./cmd/myapp(假设入口在cmd/myapp/main.go),Working directory 保持默认项目根目录 - 注意:
go run main.go和go run .行为不同 —— 前者不查go.mod,后者才按模块规则加载;GoLand 默认走后者逻辑 - 删掉项目根目录下的
go.work(如果存在),它会强制启用多模块工作区,干扰单模块项目初始化
最容易被忽略的是:GOROOT 指定后不重启 IDE,一切配置都白搭;GOPROXY 少了 ,direct,本地 replace 或未同步到镜像的新包就直接失败;还有人把 go.mod 文件误删后试图“Reload project”,其实得删项目重来——这些点不踩中,其他配置再全也没用。

















