答案是PATH未生效，需重启终端并验证go命令可用性。装完Go后go version报错主因是PATH未生效，Windows需重启CMD/PowerShell并检查Path是否含Go\bin，macOS/Linux需在~/.zshrc添加export PATH=$PATH:/usr/local/go/bin并source，验证用which go或Get-Command go。
装完 Go 二进制后直接 go version 报错，不是安装包问题，是 PATH 没生效——这是 90% 新手卡住的第一步。后续所有操作（go mod init、VS Code 的 gopls 启动、依赖下载）都依赖这一步真实可用。
验证 go 命令是否真就绪
别信安装器勾选的“添加到 PATH”，它只改了注册表或 shell 配置，但当前终端进程不读新配置。
- Windows：关掉所有 PowerShell/CMD，新开一个，运行
Get-Command go；若提示“未识别”，去「系统属性 → 高级 → 环境变量」检查C:\Program Files\Go\bin（或你自定义路径）是否在Path里 - macOS/Linux：新开终端，执行
which go；没输出？检查~/.zshrc（或~/.bash_profile）里有没有export PATH=$PATH:/usr/local/go/bin，然后手动执行source ~/.zshrc - 验证通过后，
go env -w GO111MODULE=on必须立刻执行——Go 1.21+ 虽默认开启模块，但 CI/旧脚本可能关着，不设这个，go mod init会静默失败或生成错误go.mod
go mod init 失败的三个隐藏条件
go mod init 不是“当前目录随便跑就行”，它对项目位置和残留结构极其敏感。
- 当前目录不能在
$GOPATH/src下（哪怕你没显式设GOPATH，Go 仍会 fallback 到$HOME/go/src）；否则它会强行按src/github.com/user/repo推导 module 名，导致名不匹配、后续import报错 - 项目根目录下不能有
vendor/目录；存在时go mod init可能跳过依赖分析，或与后续go mod tidy冲突 - 不要在空目录下直接
go mod init；先写好一个main.go（哪怕只有package main），否则某些旧版本 Go 会生成空go.mod或报no Go files in current directory
VS Code 中 gopls 启动失败，八成不是插件问题
gopls 是语言服务器，不是 VS Code 插件本身；它启动失败，95% 是底层依赖没满足。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 必须确保：终端里
go version和go env都能正常执行——gopls启动时会调用go命令查环境 - 项目根目录必须有
go.mod文件；没有的话gopls会降级为纯语法高亮，不提供跳转、补全 -
.go文件必须保存（不是仅打开未保存），且文件名不能是test.go这类易被误判为测试文件的命名；临时文件或错误后缀会导致gopls忽略该文件 - 国内用户务必提前执行：
go env -w GOPROXY=https://goproxy.cn,direct；否则gopls在首次加载时尝试拉取golang.org/x/tools会超时卡死，表现为“正在加载…”一直转圈
依赖下载慢或 go get 报错，代理设置要分两层
只设 GOPROXY 不够，GOSUMDB 不配也会失败——尤其当你用 go get github.com/some/pkg@v1.2.3 时。
- 执行这三行（Windows PowerShell / macOS/Linux 终端均适用）：
go env -w GO111MODULE=ongo env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=sum.golang.org - 注意：
GOSUMDB=sum.golang.org不能替换成国内镜像（如https://sum.golang.google.cn），否则go mod download会校验失败；官方明确说明该值必须是sum.golang.org或off - 验证是否生效：
go env | grep -E "(GOPROXY|GOSUMDB)"（macOS/Linux）或go env | findstr "GOPROXY\|GOSUMDB"（Windows）
最常被忽略的是：每次改完 go env 设置，VS Code 必须完全重启（不只是重载窗口），否则编辑器内嵌终端仍读旧环境变量，gopls 会沿用错误配置缓存很久。
