必须重启GoLand才能使GOROOT配置生效，因IDE仅在启动时读取该路径；需指向含src/pkg/bin的根目录（如/usr/local/go），改后点Apply并重启，验证方式为新建main.go写fmt.Println("ok")且右上角绿色三角亮起无波浪线。
GOROOT 配置必须重启 GoLand 才生效
GoLand 读取 GOROOT 是在启动时一次性加载的，改完 Settings → Go → GOROOT 后点 Apply，不重启 IDE 就等于没配。常见现象是：新建 main.go 后右上角运行按钮灰掉、fmt 标红、go run 报 “command not found”。
确认路径是否正确：/usr/local/go（macOS）、C:\Go（Windows）、/usr/local/go（Linux），且该目录下必须有 src、pkg、bin 三个子目录——别选到 bin/go。
- 删掉 Settings 里自动填入的
/usr/local/go/bin/go这类错误路径 - 重启后验证：新建文件写
fmt.Println("ok")，无波浪线 + 右上角绿色三角亮起 = 成功 - 如果仍失败，终端里执行
which go，再对比 GoLand 里填的路径是否一致
Go Modules 代理必须带 direct
只填 https://goproxy.cn 看似能拉公开包，但一旦项目引入私有模块（比如公司内网 GitLab 的 repo），就会卡在 go mod download 并报错：failed to load module requirements 或 no matching versions for query "latest"。
正确写法是：https://goproxy.cn,direct —— 逗号分隔，direct 表示对无法代理的地址（如私有域名）直接走 git clone。
立即学习“go语言免费学习笔记（深入）”；
- Settings → Go → Go Modules → Proxy 框里粘贴完整字符串，别漏逗号和
direct - 删掉项目根目录下的
go.work文件（如果存在），它会强制启用多模块工作区，干扰单模块初始化 - 右键项目根目录 → “Reload project”，不是 “Sync”；后者只刷新缓存，不触发模块解析
go run . 和 go run main.go 的行为差异
看似都能跑，但底层逻辑不同：go run . 会扫描当前目录下所有 .go 文件并合并编译，而 go run main.go 只编译显式列出的文件。容易踩坑的点在于：当 main.go 依赖同目录下另一个 utils.go，用后者会报 undefined。
更隐蔽的问题是构建约束（build tags）：如果 utils.go 开头有 //go:build !windows，而你在 Windows 上用 go run .，它会被跳过，但 go run main.go utils.go 会硬性包含，导致编译失败。
- 日常开发建议统一用
go run .，语义清晰且符合 Go Modules 默认行为 - 调试单文件逻辑时可用
go run main.go，但务必手动补全所有依赖文件 - 避免混用：不要在
main.go里 import 同目录下未显式传入的文件
VS Code 里 gopls 启动失败常因工具链缺失
装完 Go 和 VS Code 官方 Go 扩展后，状态栏显示 “Installing tools…” 卡住，或编辑器提示 “gopls is not available”，本质是缺少语言服务器二进制。这不是插件问题，而是 gopls 没装上。
手动安装命令是：go install golang.org/x/tools/gopls@latest。注意：必须确保 $GOPATH/bin（或 go env GOPATH 返回路径下的 bin）已加入系统 PATH，否则 VS Code 找不到 gopls。
- 执行命令后，检查
gopls -v是否输出版本信息 - 若因网络超时失败，先设置代理：
go env -w GOPROXY=https://goproxy.cn,direct - Mac/Linux 用户注意 shell 配置文件（
~/.zshrc或~/.bashrc）是否 source 过，新终端才生效
go.work 文件残留、GOROOT 路径末尾多加了 /bin、代理缺 direct 这三处，90% 的“环境搭好了但跑不起来”都栽在这儿。 
