GOROOT必须手动指定且重启IDE才生效，GoLand不继承系统PATH或环境变量；需填安装根目录（非bin子目录），Apply后必须重启，验证通过fmt.Println("ok")无报错且运行按钮亮起。
GOROOT必须手动指定且重启IDE才生效
GoLand不会自动继承系统PATH里的go命令，也不会读取环境变量中的GOROOT——它只认自己设置的路径。常见错误是点开Settings → Go → GOROOT后，直接粘贴/usr/local/go/bin或C:\Go\bin，结果导致标准库索引失败、fmt标红、右上角运行按钮灰掉。
正确做法：
- macOS/Linux填/usr/local/go（确认该目录下有src、pkg、bin三个文件夹）
- Windows填C:\Go（不是C:\Go\bin）
- 点Apply后，必须关闭并重新启动GoLand；仅“Reload project”或“Sync”完全无效
- 验证：新建main.go，写fmt.Println("ok")，若无波浪线且绿色三角亮起，说明对齐成功
Go Modules代理必须带direct后缀
只填https://goproxy.cn会导致私有模块解析失败，比如引用公司内网Git仓库时，GoLand会卡在“Resolving dependencies…”并最终报错no required module provides package。
Settings → Go → Go Modules里：
- 勾选Enable Go modules integration
- Proxy栏填完整值：https://goproxy.cn,direct（注意逗号+空格+direct）
- 若项目根目录存在go.work文件，务必先删掉——它会强制启用多模块工作区，干扰单模块项目初始化
- 右键项目根目录 → Reload project（不是Sync），触发完整module解析流程
运行配置不匹配会导致go run行为异常
GoLand默认用go run .执行，但如果你手动改了Run Configuration里的Program arguments为main.go，就会跳过module路径解析，导致import路径报错或找不到包。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
两种安全用法：
- 统一用模块路径：Run Configuration → Program arguments填./cmd/myapp（假设入口在cmd/myapp/main.go），Working directory保持默认项目根目录
- 按当前文件运行：Working directory改为$FileDir$，这样点击main.go旁的运行按钮时，实际执行的是go run main.go，但前提是该文件所在目录有go.mod且属于同一module
- 绝对不要混用：go run main.go不查go.mod，go run .才按module规则加载
测试函数不被识别的硬性条件
GoLand的Test图标不出现、右键没有Run Test选项，90%是因为没满足以下任一条件：
- 文件名必须严格以_test.go结尾（例如hello_test.go，hello.test.go或test_hello.go都不行）
- 函数签名必须是func TestXxx(t *testing.T)：首字母X必须大写，参数名可以是t以外的其他名字，但类型必须是*testing.T，不能省略*或写成testing.T
- 不能被构建约束屏蔽：比如文件顶部有// +build !windows，而你正在Windows上开发，该文件会被忽略
最常被忽略的一点：GoLand调试器依赖dlv，但它的安装不是“点一下就完事”。首次提示“Some tools are missing”时，必须勾选dlv并点Install——如果中途取消或网络中断，后续断点永远不生效，且IDE不会再次弹窗提醒。
