go version报command not found是PATH未生效或配置错误所致，需用which go验证路径，macOS/Linux检查shell配置文件是否正确添加/usr/local/go/bin，Windows确认系统环境变量Path包含C:\Go\bin并重启VS Code。
Go 环境搭建不是“装完就完事”，真正卡住人的从来不是下载和点击安装，而是 go version 报 command not found、go mod init 生成空 go.mod、VS Code 里 gopls 反复崩溃——这些全是环境链路断点的信号。
go version 报 command not found 怎么快速定位
这不是 Go 没装好，是 shell 找不到 go 这个可执行文件。本质是 PATH 没生效，或压根没加对。
- macOS/Linux：运行
which go，没输出就说明 PATH 里没包含 Go 的 bin 目录；检查你改的是~/.zshrc还是~/.bash_profile（Apple Silicon 默认用 zsh）；确认添加的是export PATH=$PATH:/usr/local/go/bin这类完整路径，不是$GOROOT/bin（此时$GOROOT还未定义） - Windows：在 PowerShell 里跑
Get-Command go，失败就去「系统属性 → 高级 → 环境变量」里查Path是否真含C:\Program Files\Go\bin；别信安装器勾选的“添加到 PATH”——它可能只写进用户变量，而你开的是管理员终端 - 统信 UOS 等国产系统：APT 安装后
go命令可能在/usr/bin/go，但GOROOT仍指向/usr/lib/go，这时go env GOROOT和which go路径不一致属正常，不用硬改
go mod init 为什么静默失败或生成错误 module 名
常见于旧项目迁移或新手在 $GOPATH/src 下直接初始化，go mod init 会按 GOPATH 规则推导 module 名，而不是你期望的域名路径。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 先运行
go env -w GO111MODULE=on强制启用模块模式（Go 1.21+ 默认开启，但 CI 或某些脚本可能关着） - 删掉项目根目录下的
vendor/目录（除非你明确要 vendor 依赖） - 检查当前路径是否在
$GOPATH/src内：如果是，go mod init会尝试把src/github.com/user/repo当 module 名；建议 cd 到任意非$GOPATH路径下新建项目 - 执行
go mod init example.com/myapp显式指定 module 名，比不带参数更可控
VS Code 里 gopls 启动失败的三个硬性前提
gopls 不是插件装上就行，它是个独立进程，依赖底层 go 命令可用 + 项目有 go.mod + 文件后缀是 .go。
立即学习“go语言免费学习笔记（深入）”；
-
go命令必须在终端和 VS Code 的集成终端里都能执行（有些用户终端能跑，VS Code 里却报错，是因为 VS Code 没读取你的 shell 配置，需重启 VS Code 或在设置里启用terminal.integrated.env.os） - 项目根目录下必须有
go.mod（哪怕只是空文件），否则gopls不识别为 Go 项目 - 确保打开的是
.go文件，不是.txt或无后缀文件；VS Code 右下角语言模式必须显示 “Go”，不是 “Plain Text” - 国内用户常因
gopls自动下载失败卡住：手动运行GOBIN=$(go env GOPATH)/bin go install golang.org/x/tools/gopls@latest，再配"go.toolsEnvVars": { "GOPROXY": "https://goproxy.cn,direct" }
最易被忽略的点：Go 1.21+ 已默认跳过 GOPATH，但很多教程还在教你怎么设 GOPATH。你不需要它，除非你要 go install 第三方命令到 $GOPATH/bin ——而这个动作本身也正在被 go install some/cmd@version 取代。
