go项目跑不起来90%是环境问题：goroot未指向含src/pkg/bin的根目录、goproxy缺direct导致私有模块失败、或go.work文件干扰模块加载，改设置后必须重启goland才生效。
Go 项目跑不起来，90% 是 GOROOT 没对齐、代理缺 direct、或残留 go.work 文件干扰模块加载——不是代码问题，是环境卡点。
GOROOT 必须指向根目录，重启 GoLand 才生效
GoLand 启动时读取一次 GOROOT，改了设置不重启等于白设。常见错误是选中了 C:\Go\bin 或 /usr/local/go/bin 这类子路径，导致 IDE 找不到 src 和 pkg，import 全红、fmt 标红、右上角运行按钮灰掉。
- Windows 正确路径：
C:\Go（MSI 默认安装路径）或C:\Program Files\Go（新版可能落在此） - macOS 正确路径：
/usr/local/go（PKG 默认）或/opt/homebrew/Cellar/go/1.25.6/libexec（Homebrew 安装） - Linux 正确路径：
/usr/local/go（tar.gz 解压后位置） - 验证方式：打开 Settings → Go → GOROOT，确认路径下存在
src、pkg、bin三个文件夹 - 改完必须关闭并重新启动 GoLand；点击 “Reload project” 或 “Sync” 无效
Go Modules 代理必须带 direct，否则私有模块失败
只填 https://goproxy.cn 看似能拉公开包，但一旦项目里用了公司内网 GitLab 的私有模块，就会卡在 go: downloading xxx@v0.1.0: reading xxx/go.mod at revision v0.1.0: unknown revision v0.1.0 —— 因为没 direct，代理不会跳过它去直连内网地址。
- 正确写法：
https://goproxy.cn,direct（逗号分隔，无空格） - Windows 命令行补救：
go env -w GOPROXY="https://goproxy.cn,direct" - macOS/Linux 补救：
go env -w GOPROXY=https://goproxy.cn,direct - 如果已启用 Go Modules 但依赖仍拉不下来，先执行
go clean -modcache清缓存
删掉 go.work 文件，避免多模块模式误启
GoLand 有时会自动生成 go.work，尤其在打开多个 Go 项目时。它会强制进入工作区（workspace）模式，导致单模块项目无法正常识别 go.mod，表现为：依赖不下载、go run main.go 报 no required module provides package、测试图标不出现。
- 检查项目根目录是否存在
go.work文件（文本内容通常含go 1.25和use ./xxx） - 直接删除它，然后右键项目根目录 → “Reload project”（不是 “Sync”）
- 若你确实需要多模块开发，再手动用
go work init创建，并明确use子模块路径 - 注意：
go.work和go.mod不共存于同一作用域逻辑；IDE 优先按go.work解析，而非go.mod
测试文件命名和函数签名必须严格匹配
GoLand 里 test 图标不亮、右键 Run ‘TestXXX’ 灰掉，往往不是环境问题，而是测试规范没满足。Go 的测试机制是编译期识别，IDE 依赖这些硬规则做索引。
- 测试文件名必须以
_test.go结尾（如utils_test.go，不能是test_utils.go） - 测试函数名必须以
Test开头，且首字母大写（如func TestAdd(t *testing.T)） - 函数参数必须是
*testing.T或*testing.B，不能少星号、不能换名 - 若文件顶部有构建约束（如
//go:build !windows），当前系统不匹配时测试也会被忽略 - 确认文件未被
// +build ignore或其他注释式约束屏蔽
最常被忽略的其实是 go.work 的隐式接管和 direct 的缺失——它们不报错，只让一切“看起来像在工作”，实则依赖链断裂。动手前先 ls -a 或 dir /a 看一眼有没有这个小文件，比反复重装 Go 或重配代理更省时间。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
