GoLand能跑起来需确保GOROOT指向根目录（如C:\Go或/usr/local/go）并重启生效，启用Go Modules、代理设为https://goproxy.cn,direct，删除go.work文件，且_test.go命名与TestXxx(t *testing.T)签名规范。
GoLand 能跑起来，不等于 Go 环境就配好了；右上角运行按钮灰掉、import 标红、go test 图标不出现，基本都是 GOROOT 或模块配置没对齐。
GOROOT 必须指向根目录，重启才生效
GoLand 不会自动继承系统 PATH 里的 go 命令路径，它只认你手动填的 GOROOT。填错位置（比如填成 C:\Go\bin 或 /usr/local/go/bin）会导致 IDE 找不到 src 和 pkg，后续所有依赖解析、代码跳转、格式化都会失败。
- Windows 下正确路径是
C:\Go，macOS 是/usr/local/go，Linux 通常也是/usr/local/go - 确认该路径下存在
src、pkg、bin三个文件夹 - 填完点 Apply 后，必须完全退出 GoLand 再重新打开——仅 Reload project 或点击 Sync 没用
- 验证方式：新建
main.go，写fmt.Println("ok")，如果无波浪线且右上角绿色三角亮起，说明 GOROOT 对齐
Go Modules 代理必须带 direct
只填 https://goproxy.cn 看似能下载公开包，但一旦项目里引用了私有仓库（比如公司内网 Git）、本地 replace 或未发布模块，就会卡在 go mod download 阶段，报错类似 failed to fetch 或 no matching versions。
- Settings → Go → Go Modules → Proxy：填
https://goproxy.cn,direct（逗号分隔，direct不可省略） - 删掉项目根目录下的
go.work文件——它会强制启用多模块工作区，干扰单模块项目初始化 - 右键项目根目录 → “Reload project”，不是 “Sync”；后者只刷新缓存，前者才触发完整 module 解析
- 终端执行
go mod tidy成功，且 GoLand 底部状态栏显示 “Modules loaded” 才算真正就绪
运行和调试的工作目录不能靠猜
go run main.go 和 go run . 行为完全不同：main.go 是文件级执行，不走 module path 解析；. 才按 go.mod 的 module name 加载 import 路径。混用会导致找不到包、init() 不触发、甚至 panic。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
立即学习“go语言免费学习笔记（深入）”；
- 统一推荐用
go run .模式：Run Configuration → Program arguments 留空，Working directory 设为项目根目录 - 如果想点单个
main.go就运行，把 Working directory 改成$FileDir$，但务必确保该目录下有go.mod，否则仍会失败 - 不要在非 module 根目录下建
main.go后直接点运行——IDE 可能误判为普通文件，不启动模块加载流程
测试函数识别失败，90% 是命名或签名问题
GoLand 不会主动扫描所有 *_test.go 文件，它依赖 Go 工具链的约定。哪怕函数名拼错一个字母、参数类型写成 *testing.TT，测试图标都不会出现，右键也看不到 “Run Test”。
- 文件名必须严格以
_test.go结尾，例如http_test.go，test_http.go无效 - 函数名必须是
func TestXxx(t *testing.T)：首字母T大写，Xxx首字母也必须大写，t参数类型不可简写、不可重命名 - 检查是否被构建约束屏蔽：比如文件顶部写了
// +build !windows，但在 Windows 上打开，测试函数会被忽略
最常被忽略的是 go.work 文件的存在和 direct 的缺失——它们不会报明显错误，但会让依赖时断时续、测试无法发现、甚至某些包 import 后不提示补全。配完别急着写业务，先跑通一个 go mod tidy 和一个 go test。
