go version和go env输出不一致说明环境变量未生效；常见现象是go version能输出版本但go env GOROOT为空或错误，根本原因是安装后未重启终端，导致已打开的CMD/PowerShell未加载新PATH，需关闭所有终端后新开验证。
go version 和 go env 输出不一致，说明环境变量没生效
常见现象是 go version 能输出版本，但 go env GOROOT 显示空或错误路径。根本原因是安装后没重启终端——Windows 的 MSI 安装器虽自动写入 PATH，但已打开的 CMD/PowerShell 不会自动 reload 系统环境变量。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 关闭所有已打开的终端窗口，再新开一个，重新执行
go version和go env GOROOT - Windows 用户若用 PowerShell 设置过
go env -w，CMD 读不到该配置，统一用 PowerShell 操作 - Linux/macOS 用户改完
~/.zshrc或~/.bashrc后，必须执行source ~/.zshrc（别漏掉）
GO111MODULE=auto 导致本地能跑、CI 报错
GO111MODULE=auto 是陷阱模式：有 go.mod 就启用模块，没文件就退化回 GOPATH 模式。CI 环境通常清空工作区，go.mod 未生成前就执行 go build，直接 fallback 到旧模式，依赖解析失败。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 立即运行
go env -w GO111MODULE=on，强制全局启用模块 - 验证：执行
go env GO111MODULE，输出必须是on，不是auto或空 - 旧项目迁移时，不要手动删
go.mod回退，而是用go mod init初始化模块
go get / go mod download 卡死，本质是代理没配或失效
国内直连 proxy.golang.org 基本超时，表现为命令卡在 “Fetching” 或无响应。这不是网络问题，是 Go 工具链默认不走系统代理，必须显式配置 GOPROXY。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env -w GOPROXY=https://goproxy.cn,direct（推荐，稳定且同步及时） - 如公司内网有私有代理（如 Artifactory），替换为
https://repo.yyrd.com/artifactory/aliyun-golang/,direct - 配完立刻试：新建空目录，执行
go mod init example.com/test && go mod download，5 秒内应完成 - 若仍卡住，临时加
-v参数看具体卡在哪：go mod download -v
VS Code 提示 gopls 启动失败，90% 是模块缓存损坏
现象是打开 .go 文件后，状态栏显示 “Loading…” 长时间不动，或弹出 “Failed to start language server” 错误。不是插件没装全，而是 gopls 依赖的模块元数据损坏或版本冲突。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先清理缓存：
go clean -modcache，再重拉依赖：go mod download - 确保当前目录有有效的
go.mod（哪怕只是go mod init xxx生成的空文件） - VS Code 中按
Ctrl+Shift+P→ 输入 “Go: Restart Language Server”，别重启编辑器 - 如果还失败，检查
gopls版本是否匹配 Go 版本：运行gopls version，输出中的go字段应 ≥ 当前go version主版本
模块缓存和代理配置是连通性验证中最容易被跳过的两步，但恰恰是 CI 失败和 IDE 报错的高频根因。别信“装完就能跑”，每一步都要用对应命令亲手敲出来验证输出。
