先运行go version确认是否安装及版本≥1.19，若报错或版本过低需重装；再执行go env GOROOT和go env GOPATH验证路径是否有效，避免GOPATH权限或GOBIN未加入PATH导致工具链异常。
确认系统是否已安装 Go 且版本够用
很多问题其实不是配置失败，而是 go 命令根本没装，或者装了但版本太老（比如 Ubuntu 自带的 go 常是 1.13 或更早）。运行 go version 看输出，如果报错或版本低于 1.19，就别折腾环境变量了，先重装。
- Linux/macOS 推荐直接去官网下载 tar.gz 包解压到
/usr/local/go，然后把/usr/local/go/bin加进$PATH - Windows 用户别用 Chocolatey 或 Scoop 装——它们偶尔会拉错分支；直接下 MSI 安装包，勾选“Add to PATH”
- 验证：终端新开一个窗口，执行
go env GOROOT和go env GOPATH，确保不为空且路径合理
设置 GOPATH 和 GOBIN 时避开默认陷阱
GOPATH 不再决定模块存放位置（Go 1.11+ 默认启用 module），但它仍影响 go install 的行为和某些老工具链。很多人卡在 go install 生成的二进制找不到，其实是 GOBIN 没设或没进 $PATH。
- 不要把
GOPATH设成~/go就完事——检查它是否存在、是否有读写权限（尤其 macOS 上可能被 SIP 限制） - 显式设置
GOBIN，例如export GOBIN=$HOME/go/bin，再把$GOBIN加进$PATH - 运行
go install golang.org/x/tools/gopls@latest后，用which gopls确认是否落在$GOBIN下，而不是$GOROOT/bin
启用 Go modules 后，$GOPATH/src 不再是必须的
新手常误以为项目必须放在 $GOPATH/src/github.com/xxx/yyy 才能正常构建。实际上只要目录里有 go.mod，go build 就能工作，无论你在桌面还是 /tmp 下。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 新建项目时，直接
go mod init example.com/myapp，不用管GOPATH - 依赖会缓存到
$GOCACHE（默认$HOME/Library/Caches/GoBuild或$HOME/.cache/go-build），不是$GOPATH/pkg - 若遇到
cannot find module providing package，优先检查go.mod是否存在、go版本是否支持该模块语法（如//go:embed需 1.16+）
VS Code + go extension 配置容易漏掉的关键项
装完插件后 gopls 报错、代码不提示、跳转失效，大概率是 go.toolsEnvVars 或 go.gopath 设置冲突，而非插件本身问题。
立即学习“go语言免费学习笔记（深入）”；
- VS Code 设置里搜
go.toolsEnvVars，填入：{"GOPATH": "/your/real/gopath", "GOBIN": "/your/real/gobin"}（路径必须绝对且真实存在） - 禁用
go.gopath——这个旧配置项会覆盖环境变量，导致gopls用错路径 - 重启 VS Code 后看右下角状态栏的
gopls版本号，如果显示 “starting…” 卡住，执行killall gopls再重试
真正麻烦的从来不是装 Go，而是不同工具对 GOPATH、GOBIN、module 模式的理解不一致。每次出问题，先查 go env 输出，再比对实际命令行和编辑器看到的环境变量是否一致。
