仅go version成功不能说明环境无误，真正要验证的是编译器、模块系统、工具链、网络代理四者能否协同工作；重点检查which go与go env GOROOT是否一致、GO111MODULE=on、GOPROXY设为国内代理、$GOPATH/bin在PATH中。
仅 go version 成功不能说明环境无误，真正要验证的是编译器、模块系统、工具链、网络代理四者能否协同工作——尤其在跨平台部署或团队协作时，GOROOT 路径错位、GO111MODULE 状态残留、GOPROXY 不可用这三类问题最常导致“本地能跑，CI/服务器上失败”。
检查 which go 和 go env GOROOT 是否指向同一路径
这是所有问题的起点。很多用户 go version 有输出，但 which go 返回空，或指向 /usr/bin/go（系统包管理器装的旧版），而 go env GOROOT 却是 /usr/local/go（手动解压的新版）——二者不一致会导致 go run 找不到标准库。
-
which go必须输出你解压 Go 的真实 bin 路径，比如/usr/local/go/bin/go或C:\Go\bin\go.exe -
go env GOROOT必须和上面路径的父目录完全一致（去掉/bin/go） - 若不一致：Linux/macOS 运行
go env -w GOROOT=""清空手动设置，让 Go 自动推导；Windows 用户检查系统环境变量里是否有多余的GOROOT条目 - 注意：Windows 上安装到
C:\Program Files\Go会因空格导致后续go build失败，官方明确不支持含空格路径
验证 GO111MODULE=on 且 go mod init 能生成干净 go.mod
旧项目迁移或新手误入 $GOPATH/src 目录下初始化，常触发 GO111MODULE=auto 模式，导致 go mod init 静默失败、不生成 go.mod，后续 go run 就报 “cannot find module providing package”。
- 运行
go env GO111MODULE，输出必须是on，不是auto或空 - 新建空目录，确保该目录下没有
go.mod，再执行go mod init example.com/test - 成功后应立即生成
go.mod文件，内容含module example.com/test和go 1.xx行 - 若失败，别用
go mod edit修，直接删掉go.mod和go.sum重来
用带第三方依赖的 go run 测试 GOPROXY 和 sum.golang.org 连通性
只跑 fmt.Println 是不够的。很多环境卡在下载 golang.org/x/... 包这步，本质是代理不可用或校验被绕过。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 在刚初始化的模块目录下，写一个
main.go，import"golang.org/x/net/html" - 执行
go run main.go—— 若卡住或报cannot find module，先检查go env GOPROXY - 国内用户必须设为
https://goproxy.cn,direct或https://repo.yyrd.com/artifactory/aliyun-golang/,direct，不能留空或只写https://proxy.golang.org - 同时确认
GOSUMDB=sum.golang.org（不能设为off），否则模块哈希校验失效，CI 构建可能被投毒
确认 $GOPATH/bin 在 PATH 中且 go install 命令可全局调用
IDE（如 VS Code）依赖 gopls，调试器依赖 dlv，它们都靠 go install 安装到 $GOPATH/bin，再由 shell 查找执行。路径没进 PATH，就等于工具链断了。
- 运行
go env GOPATH，记下路径（默认$HOME/go） - 检查
echo $PATH（Linux/macOS）或echo %PATH%（Windows）是否包含$GOPATH/bin - 执行
go install golang.org/x/tools/cmd/gopls@latest，成功后直接输入gopls version应有输出 - 若提示
command not found，说明$GOPATH/bin没生效；Windows 用户还要确认是 PowerShell 还是 CMD —— 两者配置文件不同（$PROFILEvsAutoRun）
真正容易被忽略的点是：环境变量修改后，终端会话未重新加载配置（source ~/.bashrc 或重启终端），以及 Windows 上 MSI 安装器自动添加的 PATH 条目被手动编辑覆盖。验证不是一次性的动作，而是每次换机器、切分支、拉新项目前的必检项。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
