验证Go环境是否成功搭建的核心是确认go命令全局可用：先执行go version输出版本号，再用which go（macOS/Linux）或Get-Command go（Windows）确认路径；若失败则检查GOROOT/bin是否加入PATH并重启终端或source配置文件，最后在空目录运行go mod init example.com/hello验证模块功能。
装好 go 命令并让它在任意目录下可用，就是 Golang 环境搭建的全部核心——不需要 IDE、不依赖 GUI、不靠插件堆砌。其他所谓“配置”都是围绕它展开的补救或优化。
验证 go 是否真可用，而不是“以为装好了”
很多人执行 go version 报 command not found，不是没装，是 PATH 没生效。
- macOS/Linux：运行
which go，有输出才表示终端能找到；没有就去检查/usr/local/go/bin（或你解压的路径）是否加进了~/.zshrc或~/.bash_profile的PATH - Windows：用 PowerShell 运行
Get-Command go，失败就去「系统属性 → 高级 → 环境变量」里确认C:\Go\bin（或你自定义路径）进了用户或系统PATH - 别信安装器勾选的“添加到 PATH”——它只改注册表或 shell 配置文件，**必须重启终端或手动
source ~/.zshrc才生效**
go mod init 失败？先清掉干扰项
在空目录下跑 go mod init example.com/hello 却生成空 go.mod 或报错，大概率是当前环境残留了旧模式痕迹。
- 删掉项目根目录下的
vendor/目录（除非你明确要用 vendor） - 运行
go env -w GO111MODULE=on强制启用模块模式（Go 1.16+ 默认开启，但 CI 或老脚本可能关着） - 检查当前目录是否在
$GOPATH/src下——如果是，go mod init会尝试按 GOPATH 路径推导 module 名，极易出错；建议直接切到~/projects/hello这类非 GOPATH 路径新建项目
go install 提示 cannot find module providing package
这是 Go 1.16+ 启用模块后最典型的命令行工具安装失败原因：Go 不知道该从哪找包，因为它现在只认 go.mod 上下文。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 退出任何含
go.mod的项目目录再执行，比如cd ~ && go install golang.org/x/tools/gopls@latest - 必须带版本后缀：
@latest或@v0.14.0，Go 1.21+ 不接受无版本的go install xxx - 如果还失败，加
-v参数看具体卡在哪，常见是代理问题，可临时设go env -w GOPROXY=https://goproxy.cn,direct
VS Code 里 gopls 启动失败，和插件无关
gopls 是语言服务器，不是“装上插件就自动好”。它启动失败，90% 是因为底层 go 命令或项目结构不合规。
- 确保
go命令全局可用（which go或Get-Command go有输出） - 打开的文件夹必须包含
go.mod（哪怕刚go mod init出来），且文件后缀是.go - 不要在
$GOPATH/src下开项目——gopls会误判为旧模式，拒绝加载
真正容易被忽略的是：go 命令本身是否在所有终端会话中都一致可用。不同 shell（zsh/bash/PowerShell）、不同终端应用（iTerm/Terminal/Windows Terminal）、甚至 VS Code 内置终端，都可能读取不同的配置文件。验证时务必在你实际写代码的那个终端里跑 go version 和 go env。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
