goland 能否正常运行取决于 goroot 是否指向真实 go 根目录、go.work 文件是否被误留、proxy 配置是否包含 direct；三者任一出错会导致运行按钮灰掉、import 标红、test 不识别等问题。
GoLand 能不能跑起来，不取决于你装了多少插件，而取决于 GOROOT 是否指向真实 Go 安装根目录、go.work 文件是否被误留、以及 Proxy 配置里有没有 direct —— 这三处出错，90% 的“运行按钮灰掉”“import 标红”“test 不识别”问题就解决了。
GOROOT 必须是根目录，不是 bin 路径
GoLand 启动时会扫描该路径下的 src、pkg、bin 三个文件夹来确认 Go 工具链完整性。如果你在 Settings → Go → GOROOT 里填的是 C:\Go\bin\go.exe 或 /usr/local/go/bin，它会直接报错或静默失效。
- Windows 正确路径示例：
C:\Go（MSI 默认安装）或E:\Go（自定义路径） - macOS 正确路径示例：
/usr/local/go（pkg 安装）或/usr/local/opt/go/libexec（Homebrew 安装） - Linux 正确路径示例：
/usr/local/go - 填完必须点击 Apply，然后完全退出并重启 GoLand——仅 Reload project 无效
Go Modules 代理必须带 direct
只填 https://goproxy.cn 看似能下载公开包，但一旦项目引用了本地模块、Git 私有仓库或未发布版本，就会卡在 go list -m all 阶段，且 IDE 不报明确错误。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- Settings → Go → Go Modules → Proxy 填写：
https://goproxy.cn,direct（注意逗号分隔，无空格） - 如果公司内网用自建代理，格式同理：
https://proxy.internal.company.com,direct - 删掉项目根目录下可能残留的
go.work文件——它会强制启用多模块工作区，干扰单模块项目初始化 - 右键项目根目录 → Reload project（不是 Sync）触发完整 module 解析
运行配置要匹配 go run 的语义
go run main.go 和 go run . 行为完全不同：前者只编译当前文件，不解析 import 路径；后者才按 module 规则加载依赖。GoLand 默认用前者，容易导致 “undefined: xxx” 错误。
- 编辑 Run Configuration → Working directory 设为
$ProjectFileDir$（项目根目录），Program arguments 留空 - 或者改用
go run ./...模式：在 Program arguments 填.，确保 Working directory 是项目根目录 - 若入口文件不在根目录（如
cmd/myapp/main.go），Program arguments 填./cmd/myapp，不要加main.go - 避免混用
go run main.go和go run .，尤其在有replace或require的go.mod里
测试函数不显示？先看命名和签名
GoLand 的 test 图标不亮，95% 是因为没满足最基础的两个硬性条件，跟 GOPATH 或代理无关。
- 文件名必须以
_test.go结尾，例如http_test.go，test_http.go无效 - 函数名必须是
TestXxx格式（首字母大写 + 驼峰），参数类型严格为*testing.T，不能是t *test.T或t *testing.B - 函数不能被构建约束屏蔽：确保没有
//go:build !windows这类注释意外禁用了当前平台 - 如果刚新建文件，右键文件 → Reload project 一次，让 IDE 重新扫描测试函数
真正卡住人的地方，往往不是“怎么配”，而是“配完没重启”“代理少写了 direct”“go.work 残留没删”——这些点不显眼，但会彻底阻断后续所有操作。动手前先确认这三件事，比反复重装 Go 或 GoLand 有效得多。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
