go version能正常输出版本号才算真正跑通基础环境；需检查PATH是否包含$GOROOT/bin并生效，显式设置GOROOT和GOPATH，验证go version、go env GOROOT、go env GOPATH三命令，且必须配置GOPROXY代理。
go version 能正常输出版本号，才算真正跑通了基础环境。其他配置都只是为后续开发铺路，但这条命令失败，说明路径或二进制根本没被系统识别。
确认 go 命令是否可用（最常卡住的一步）
很多初学者在安装后直接运行 go version 报错 command not found，不是没装好，而是 PATH 没生效。
- Linux/macOS：检查
~/.bashrc、~/.zshrc或/etc/profile是否添加了$GOROOT/bin，且执行过source ~/.zshrc（注意 shell 类型，Zsh 用户别用bashrc） - Windows：右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，确认
Path里有%GOROOT%\bin，且GOROOT变量本身已正确定义（如C:\Go） - 别信“安装完就自动配置”——.msi/.pkg 安装器在某些系统（如统信UOS、深度Deepin、macOS Monterey 后的 Zsh 默认环境）下可能漏写 PATH，必须手动验证
GOROOT 和 GOPATH 的最小必要配置
Go 1.16+ 已默认启用 modules，GOPATH 不再是强制项，但初学者仍建议显式设一个，避免工具（如 VS Code 的 Go 扩展）误判工作区。
-
GOROOT：指向 Go 安装根目录，如/usr/local/go（Linux/macOS）或C:\Go（Windows）。它只应包含官方二进制和标准库，**不要把项目放这里** -
GOPATH：初学者设为$HOME/go（Linux/macOS）或%USERPROFILE%\go（Windows）即可。它只是存放src（可选）、pkg、bin的地方，现代项目代码可以放在任意路径，不强制放$GOPATH/src - 如果只写
export PATH=$PATH:$GOROOT/bin而不设GOROOT，部分工具（如go env）会 fallback 到默认路径，但行为不稳定；显式声明更可控
验证三件套命令必须全部通过
光看 go version 不够，这三个命令缺一不可，它们分别验证不同层面：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
-
go version→ 二进制存在且可执行 -
go env GOROOT→ 环境变量解析正确，路径可访问 -
go env GOPATH→ 工作目录路径已设定，后续go install才能落进$GOPATH/bin - 若
go env GOPATH输出空或~/go但该目录不存在，手动建一下：mkdir -p $HOME/go/{bin,pkg,src}，否则某些老教程里的go get会静默失败
代理不是可选项，而是国内开发的事实必需
不配代理，go mod download 或 go get 十有八九卡死或报 timeout / checksum mismatch，这不是网络问题，是模块校验机制触发的失败。
- 立即执行：
go env -w GOPROXY=https://goproxy.cn,direct（国内推荐）或https://proxy.golang.org（需配合科学上网） - 验证是否生效：
go env GOPROXY应输出设置的值，不是空或https://proxy.golang.org（未覆盖时的默认值） - 注意：设置后所有新终端生效，旧终端需重新
source配置或新开窗口；VS Code 需重启窗口才能读取新环境变量
最容易被忽略的是 shell 类型和配置文件的匹配（Zsh 用户改了 .bashrc 白搭），以及代理设置后不重启编辑器导致插件持续拉取失败。环境变量这层薄，但每一步都得踩实。
