GoLand正常运行Go代码的关键在于正确配置GOROOT、Go Modules代理和工作区文件：GOROOT须指向含src/pkg/bin的Go根目录并重启IDE；代理需设为“https://goproxy.cn,direct”；必须删除go.work文件后Reload project；工作目录应保持$ProjectFileDir$；测试文件需以_test.go结尾且函数名符合TestXxx规范。
GoLand 能否正常运行 Go 代码，不取决于“是否装了 Go”，而取决于它能否用对的路径找到 go 命令、标准库和模块元数据。填错 GOROOT、漏掉 direct、残留 go.work，这三件事占了 80% 的配置失败原因。
GOROOT 必须指向根目录，且重启才生效
GoLand 不读系统环境变量里的 GOROOT，只认自己 Settings 里填的路径。填成 /usr/local/go/bin 或 C:\Go\bin\go.exe 是最常见错误——IDE 会找不到 src 和 pkg，导致 fmt 标红、跳转失效、运行按钮灰色。
- 正确路径示例：
/usr/local/go（macOS/Linux）、C:\Go（Windows 默认）、$HOME/sdk/go1.22.0（用户级安装） - 验证方式：打开该路径，确认直接包含
src、pkg、bin三个文件夹 - 改完必须关闭并完全重启 GoLand —— 点
Apply或Reload project都不触发重载 - 终端执行
go env GOROOT输出应与 GoLand 中设置的路径一致
Go Modules 代理必须带 direct，且删掉 go.work
只配 https://goproxy.cn 会导致私有模块、本地路径模块或 replace 规则全部解析失败，现象是 go get 卡住、import 标红、go mod tidy 报 “no required module provides package”。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- Settings → Go → Go Modules → Proxy 填：
https://goproxy.cn,direct（逗号分隔，**中间不能有空格**） - 如果项目根目录存在
go.work文件，直接删掉它 —— 它会强制启用多模块工作区，覆盖单模块行为 - 删完后右键项目根目录 →
Reload project（不是Sync），让 gopls 重新扫描go.mod - 状态栏应显示
gopls (running) · github.com/yourname/project，否则模块未被识别
运行配置的工作目录别乱设，尤其别用 $ProjectFileDir$
工作目录（Working directory）错位不会影响编译，但会让 os.Open("config.yaml")、http.Dir("./static")、template.ParseFiles("tmpl/*.html") 全部失败，报 file not found 或绑定端口失败。
- 默认保持为
$ProjectFileDir$（即go.mod所在目录）是最安全的选择 - 若想点击某个子目录下的
main.go就以该目录为起点运行，设为：$FileDir$ - 绝对不要设成
$ProjectFileDir$以外的宏变量，比如$ContentRoot$或自定义路径 —— GoLand 对这些变量的解析在跨模块时极不稳定 - 调试时可在入口加一行：
fmt.Println("wd:", os.Getwd())实时确认当前工作目录
测试函数不显示运行图标？先查命名和构建约束
GoLand 不识别测试函数，通常不是配置问题，而是代码层面没满足 Go 测试机制的基本要求。
- 文件名必须严格以
_test.go结尾，例如handler_test.go，test_handler.go无效 - 测试函数名必须是
TestXxx形式（首字母大写 + 驼峰），且参数为*testing.T，例如：func TestLogin(t *testing.T) - 检查是否有
//go:build或// +build构建约束注释屏蔽了该文件（比如写了//go:build !windows但在 Windows 上开发） - 光标放在函数名上，右键应出现
Run 'TestXxx'，没有说明 IDE 没把它当测试函数处理
真正卡住人的地方，往往不是“该不该配”，而是“配了但没生效”——比如改了 GOROOT 没重启、配了代理但漏了 direct、删了 go.work 却点了 Sync 而非 Reload project。这些动作看似微小，却直接决定 IDE 是帮你写代码，还是天天跟你对抗。
