高清步骤带你完成GoLand环境搭建-Golang-PHP中文网

goland报“no go sdk found”或运行按钮灰掉，根本原因是goroot未手动指定为go安装根目录（如/usr/local/go或c:\go），且必须重启ide生效；路径下须含src、pkg、bin三目录，代理需设为https://goproxy.cn,direct。

高清步骤带你完成goland环境搭建

GoLand 跑不起来，根本不是 IDE 问题，而是它压根没认出你装的 Go —— GOROOT 指错、go 命令在终端能跑但在 IDE 里报 “No Go SDK found”，或者右上角运行按钮灰掉，全是这个原因。

GoLand 不继承系统 PATH，也不信“Auto-detect”。它只认你填进去的那个路径，而且必须是 Go 安装根目录（不是 bin 子目录）。

GOROOT 路径下必须包含 src、pkg、bin 三个文件夹；macOS 通常为 /usr/local/go，Windows 通常为 C:\Go（MSI 安装默认路径），Homebrew 安装则多为 /opt/homebrew/opt/go/libexec
Settings → Go → GOROOT → 点右侧文件夹图标选择，别手输、别选到 bin/go
点 Apply 后，必须关闭并完全重启 GoLand —— Reload project 或 Sync 都无效，GUI 进程不重启，GOROOT 就不会被重载
验证方式：新建 main.go，写 fmt.Println("ok")，如果 import 不红、右上角绿色三角亮起，说明识别成功

即使 GOROOT 对了，import 仍标红、go get 超时，大概率是模块开关没开，或代理配置不完整。

GoLand 2026.1.1

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

下载

Settings → Go → Go Modules → 勾选 “Enable Go modules integration”
GOPROXY 必须设为 https://goproxy.cn,direct —— 缺少 ,direct 会导致私有包、本地 replace、新发布包直接失败
删掉项目根目录下的 go.work 文件（如果存在），它会强制启用多模块工作区，干扰单模块项目初始化
右键项目根目录 → “Reload project”，不是 “Sync”；后者只刷新缓存，前者才触发完整 module 解析
终端执行 go env GO111MODULE，输出必须是 on；如果不是，运行 go env -w GO111MODULE=on

点击 main.go 旁的绿色三角没反应？不是代码问题，是 GoLand 不知道该用什么路径去执行 go run。

编辑 Run Configuration → Working directory 设为 $FileDir$ ，这样点哪个 main.go 就以它所在目录为起点执行 go run main.go
或者统一用模块路径：Program arguments 填 ./cmd/myapp（假设入口在 cmd/myapp/main.go），Working directory 保持默认项目根目录
注意：go run main.go 和 go run . 行为不同 —— 前者不解析 module import 路径，后者才按 go.mod 规则加载；GoLand 默认走后者逻辑，所以入口路径必须能被模块路径解析
项目路径不能含中文、空格或符号（如 ~/Desktop/我的项目），否则 module 初始化失败；改用 ~/go/src/hello 类路径

GoLand 不识别测试函数，不是插件没装，而是它根本没把文件当测试文件读。

文件名必须严格以 _test.go 结尾，比如 hello_test.go，hello.test.go 或 test_hello.go 都不行
函数名必须是 func TestXxx(t *testing.T) 格式：首字母 T 大写，Xxx 首字母也必须大写（如 TestHello），参数类型必须是 *testing.T
函数不能被构建约束屏蔽 —— 检查文件顶部是否有 //go:build !windows 这类注释，且当前系统是否匹配
确保 go test 在终端能跑通；如果终端也失败，IDE 自然不会显示图标