go version报command not found说明PATH未包含$GOROOT/bin；输出devel版本则可能安装了非稳定版，生产环境应使用官网稳定包，并确认GOROOT指向安装根目录而非bin子目录。
go version 命令报错或输出异常
这是最直接的校验失败信号。如果终端输入 go version 后提示 command not found，说明 PATH 没有包含 $GOROOT/bin；如果输出类似 go version devel go1.23-xxx linux/amd64（非稳定版），可能装了 beta 或源码编译版本，生产环境建议换回官网下载的稳定包。
- 检查
GOROOT是否指向解压后的 Go 安装目录（如/usr/local/go），不是/usr/local/go/bin - 确认
PATH中$GOROOT/bin出现在$GOPATH/bin之前，避免旧版本命令被优先命中 - Windows 用户注意：CMD 和 PowerShell 的环境变量不互通，改完要重启终端或重新运行
setx命令
go env GOPATH 返回空或路径错误
go env GOPATH 返回空值是正常现象（Go 1.16+ 默认模块模式下不强制依赖 GOPATH），但若返回一个奇怪路径（比如 /root/go 而你用普通用户登录），说明环境变量配置被全局文件（如 /etc/profile）覆盖，或 shell 配置文件未正确加载。
- 运行
echo $GOPATH看是否与go env GOPATH一致 —— 不一致说明go env读的是缓存值，执行go env -u GOPATH清除后重试 - 不要把项目放在
$GOPATH/src下再跑go mod init，这会导致模块路径解析失败，报错cannot find module providing package - 如果必须设
GOPATH（如配合某些老 IDE），用go env -w GOPATH=$HOME/go，而非直接 export
go mod download 卡住或校验失败
执行 go mod download（或 go run main.go 触发依赖拉取）时卡在 github.com/xxx@v1.2.3: verifying... 或报 checksum mismatch，本质是代理或校验服务器不可达。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 国内环境务必设置
GOPROXY：运行go env -w GOPROXY=https://goproxy.cn,direct（清华源也行，但goproxy.cn更稳定） -
GOSUMDB不建议关成off，生产环境应保留sum.golang.org，配合代理即可；仅测试时可临时go env -w GOSUMDB=off - 验证代理是否生效：运行
go env GOPROXY，输出应为完整 URL，不含空格或多余逗号
hello.go 能跑但 HTTP 服务无法从外部访问
写个 net/http 服务监听 :8080，go run hello.go 控制台显示启动成功，但宿主机浏览器打不开 http://localhost:8080，常见于云服务器或 Docker 场景。
立即学习“go语言免费学习笔记（深入）”；
- 服务代码里监听地址必须是
":8080"或"0.0.0.0:8080"，不能写"127.0.0.1:8080"（后者只允许本机 loopback 访问） - 云服务器需确认安全组放通对应端口；本地 Docker 容器需在
docker-compose.yml中显式映射ports: ["8080:8080"] - macOS / Windows 上用
host.docker.internal访问宿主服务，Linux 需额外配置或改用network_mode: "host"
go version 验证安装路径，go env 验证变量作用域，go mod download 验证网络链路，net/http 服务验证监听行为。漏掉任意一环，后续写 Gin、JWT 或微服务时都会突然卡住，而且错误堆栈往往不直接指向根源。 
