goland跑不起来主因是未手动配置goroot且未重启生效：需先确保终端go version可运行，再在settings→go→goroot中填入go根目录（非bin路径），apply后必须重启goland；同时启用go modules并配置代理https://goproxy.cn,direct，最后重载项目。

GoLand 跑不起来，90% 不是 Go 没装好，而是它根本没“看见”你装的 Go —— 它不认系统 PATH，也不自动猜路径，必须你亲手指给它看 GOROOT，而且得重启才生效。

GoLand 找不到 Go SDK？先确认终端里 go version 能跑通

这是所有问题的起点。如果在终端（CMD / Terminal / PowerShell）里敲 go version 报错或没输出，GoLand 一定失败。

• Windows：检查 %PATH% 是否包含 C:\Go\bin（MSI 默认路径）或你自定义安装路径下的 \bin 子目录
• macOS/Linux：运行 echo $PATH，确认含 /usr/local/go/bin 或 /opt/homebrew/bin（Homebrew 安装）
• 改完 PATH 后，必须关掉所有终端窗口再重开——不是“重启电脑”，是“重启终端进程”

Settings → Go → GOROOT 必须手动填对，且不能选错目录

GoLand 的 GOROOT 不是填 go 命令路径，也不是填 /usr/local/go/bin，而是填 Go 的根安装目录。

GoLand 2026.1.1

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

下载

• macOS（pkg 安装）：填 /usr/local/go
• macOS（Homebrew）：填 /opt/homebrew/opt/go/libexec（用 brew --prefix go 确认）
• Windows（MSI 默认）：填 C:\Go；若装到 D:\software\Go，就填 D:\software\Go
• 填完点 Apply，然后——必须关闭并重新启动 GoLand，否则设置不加载
• 验证：新建 main.go，写 fmt.Println("ok")，右上角绿色三角亮起、无波浪线，才算成功

代理和模块不配好，import 会一直标红

GoLand 依赖 go mod 解析依赖，但默认不启用模块，也不走代理，所以 import 标红、go get 超时都是连锁反应。

• 进 Settings → Go → Go Modules，勾选 Enable Go modules integration
• Proxy 栏填完整值：https://goproxy.cn,direct（注意逗号 + direct，缺了会导致私有包失败）
• 删掉项目根目录下的 go.work 文件（它会强制开启多模块工作区，干扰单模块项目）
• 右键项目根目录 → Reload project（不是 Sync），触发完整 module 初始化
• 顺手执行一次 go clean -modcache，清掉旧缓存再试

测试函数不显示运行图标？文件名和函数签名一个都不能错

GoLand 识别测试靠硬规则，不是靠内容分析。

• 文件名必须以 _test.go 结尾，例如 hello_test.go，不能是 test_hello.go 或 hello.test.go
• 函数名必须是 TestXxx 形式（首字母大写 + Test 开头），例如 TestHello、TestHTTPHandler
• 函数签名必须严格为 func TestXxx(t *testing.T)，参数名 t 可换，但类型 *testing.T 不能少
• 别被 //go:build 构建约束屏蔽：比如文件开头有 //go:build !windows，而你在 Windows 上打开，测试就不可见

最常被忽略的一点：GoLand 的 Terminal 默认 shell 可能和你日常用的不一致（比如系统用 zsh，GoLand 配了 bash），导致 PATH 不同步——进 Settings → Tools → Terminal，把 Shell path 改成和终端一致的路径，比如 macOS 上填 /bin/zsh。