Go环境需满足三要素：go命令可用（验证which go或Get-Command go）、GO111MODULE=on强制启用模块模式、项目不在$GOPATH/src内且无vendor目录；国内还需配置GOPROXY如https://goproxy.cn,direct，缺一不可。
Go 环境不是“装完就跑”，而是 go 命令可用 + 模块模式启用 + 项目路径干净，三者缺一不可。很多人执行 go mod init 后发现 go.sum 空、依赖拉不下来、gopls 报错，根源几乎都卡在这三个点上。
验证 go 命令是否真可用，而不是“看起来可用”
安装包勾选了“添加到 PATH”不等于终端能立刻识别——这是最常被忽略的一步。
- macOS / Linux：运行
which go，有输出才表示 PATH 生效；没输出就检查~/.zshrc或~/.bash_profile是否写了export PATH=$PATH:/usr/local/go/bin（或对应安装路径），然后执行source ~/.zshrc - Windows：在 PowerShell 中运行
Get-Command go，失败就去「系统属性 → 高级 → 环境变量」确认C:\Program Files\Go\bin（或你自定义的路径）是否在用户或系统PATH中 - 别信
go version成功就万事大吉：它可能来自旧版本残留（比如 Ubuntu 自带的apt install golang装的 1.18），用go env GOROOT确认实际加载的是哪个安装目录
强制启用模块模式，绕过 GO111MODULE=off 遗留陷阱
Go 1.16+ 默认开启模块，但 CI 脚本、老终端配置、某些 IDE 插件仍可能把它关掉，导致 go mod init 静默降级为 GOPATH 模式。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 运行
go env -w GO111MODULE=on全局启用（推荐） - 检查是否生效：
go env GO111MODULE应输出on - 如果项目已有
vendor/目录，go mod init可能跳过生成go.mod或写入错误内容——先手动删掉vendor/ - 避免在
$GOPATH/src下初始化项目：否则模块名会按旧路径推导（如github.com/xxx/yyy），容易和真实 import 路径不一致
国内环境必须配 GOPROXY，否则 go get 和 gopls 启动直接卡死
默认代理 https://proxy.golang.org,direct 在国内基本不可用，所有依赖下载、工具安装（如 gopls）、甚至 VS Code 的自动补全都会失败。
- 设为阿里云镜像：
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct - 或清华源：
go env -w GOPROXY=https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct - 设完后测试：
go list -m golang.org/x/tools，能快速返回版本号即成功 - VS Code 中
gopls启动失败，90% 是因为没配GOPROXY或go不在 PATH —— 它不会报明确错误，只显示 “Loading…” 或语言功能失效
真正麻烦的从来不是“怎么装”，而是不同来源的配置（系统 PATH、shell 配置、IDE 内置 shell、CI 脚本）之间互相覆盖。建议每次新开终端都跑一遍 go env | grep -E "(GO111MODULE|GOPROXY|GOROOT|PATH)"，眼见为实。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
