必须检查goroot、gopath、go111module、goproxy、gosumdb五项：goroot需指向真实安装路径且含bin/go和src/runtime；gopath若设置则不可与项目路径重叠；go111module必须为on；goproxy国内须含有效镜像并以,direct结尾；gosumdb建议设sum.golang.google.cn或off。
go env 输出里哪些字段必须检查
安装完 Go 后，go env 是唯一能一次性暴露全部环境状态的命令。别只看 go version 成功就以为万事大吉——很多依赖拉不下来、模块找不到、IDE 报红，根源都在这几个字段上：
-
GOROOT：必须指向真实的 Go 安装目录（如C:\Go或/usr/local/go），且该路径下必须存在bin/go和src/runtime；如果值是空或错误路径，gopls会直接启动失败 -
GOPATH：Go 1.16+ 已非必需，但若设了，就不能和项目路径重叠（比如项目在$GOPATH/src/xxx里），否则go mod可能降级到 GOPATH 模式，导致require不生效 -
GO111MODULE：必须是on（不是auto或空），否则新建项目不生成go.mod，go get会静默忽略模块语义 -
GOPROXY：国内用户必须含有效镜像地址（如https://goproxy.cn）并以,direct结尾；若显示https://proxy.golang.org或为空，go mod tidy十有八九卡在Fetching github.com/gorilla/mux -
GOSUMDB：建议设为sum.golang.google.cn（国内可用）或off（仅调试时临时用），设成默认的sum.golang.org在无代理环境下会校验失败
go list -m all 报错说明什么依赖链断了
在项目根目录运行 go list -m all，它不编译代码，只解析模块图。输出异常往往比 go build 更早暴露问题：
- 出现
cannot load module：说明go.mod里某个require的版本在GOPROXY上根本不存在，常见于手动写了不存在的 commit hash 或 pre-release 版本（如v1.2.3-20230101abcdef） - 卡住不动超过 30 秒：大概率是
GOPROXY配置无效或网络不通，可临时加-v参数看具体卡在哪条 URL 上 - 输出里有
// indirect但没对应require行：表示某个依赖被间接引入但未显式声明，go mod tidy会自动补全；但如果补全后仍报missing go.sum entry，说明GOSUMDB拒绝校验该模块
为什么 goland 里能跑但终端 go run 失败
这不是环境问题，是工具链加载路径不一致。GoLand 默认用自己的 GOPATH 和 GOPROXY 配置，和终端 shell 无关：
- 检查 GoLand 的
Settings > Go > GOROOT是否指向和go env GOROOT一致的路径；不一致会导致 IDE 用一套 stdlib，终端用另一套，go run可能报undefined: sync.Pool这类底层类型错误 - GoLand 的 Terminal 默认继承系统环境变量，但如果你在 IDE 内置终端里执行过
export GOPROXY=...，它不会同步到外部 CMD/PowerShell，反之亦然 - 最典型的症状是：IDE 里点绿色三角能运行，但终端执行
go run main.go报package not found—— 八成是终端当前目录不在模块根目录，或者go.mod文件权限被 IDE 锁死（macOS 常见）
go build -x 显示的命令行暴露了什么
go build -x 会打印出所有实际执行的子命令（如 compile、link、gcc 调用）。这是定位 Cgo 或交叉编译失败的唯一可靠方式：
- 如果看到
gcc: command not found：说明缺失 C 工具链，Windows 需 MinGW-w64，macOS 需xcode-select --install，Linux 需build-essential - 出现
ld: library not found for -lcrypto：Mac 上 OpenSSL 版本冲突，需用brew install openssl并设置CGO_CFLAGS和CGO_LDFLAGS - 路径里含
$WORK/b001/_pkg_.a但最后报no such file：说明GOROOT下的pkg目录权限异常，尤其 Windows 上杀毒软件常拦截写入
go env 看着都对，go run 却在某个依赖的第二层间接引用上静默失败——这时候得靠 go list -m all -json 输出结构化数据，再逐个 curl -I 验证 proxy 返回码。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
