答案是PATH未配置导致go命令不可见：Windows需确认MSI安装时勾选“Add Go to PATH”或手动将C:\Go\bin加入环境变量，Linux/macOS需在~/.zshrc等文件中添加export PATH=$PATH:/usr/local/go/bin并source，所有平台均须新开终端验证。
go version 命令报“不是内部或外部命令”
这说明 go 二进制文件不在系统 PATH 中，不是 Go 没装，而是终端找不到它。
- Windows 用户：检查安装时是否勾选了 “Add Go to PATH”（MSI 安装器默认勾选，但手动解压版或某些精简包不会自动加）
- Linux/macOS 用户：确认
/usr/local/go/bin（或你解压的路径，如$HOME/sdk/go/bin）已写入 shell 配置文件（~/.zshrc或~/.bashrc），且执行过source ~/.zshrc - 所有平台：新开一个终端窗口再试 —— 环境变量修改后旧终端不会自动刷新，PowerShell 尤其容易忽略这点
go env -w 设置代理和模块开关
国内用户不配 GOPROXY，go mod download 和 go install 基本会卡死或超时。
- 必须运行这三条命令（永久生效）：
go env -w GO111MODULE=ongo env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=sum.golang.org -
direct是关键：当代理镜像里没有某个包时，会自动回源官方地址，避免“404 包不存在”的假失败 - 验证是否生效：
go env | findstr GOPROXY（Windows）或go env | grep GOPROXY（macOS/Linux）
go mod init 初始化失败或依赖拉不下来
常见现象是 go: downloading ...: Get "https://proxy.golang.org/...": dial tcp: lookup proxy.golang.org: no such host，本质是 DNS 或代理未生效。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 先确保当前目录是空的、没
go.mod文件 —— 在已有项目里乱跑go mod init可能破坏原有模块路径 - 如果刚配完
GOPROXY还失败，清一下模块缓存：go clean -modcache，再重试 - 临时绕过代理调试（仅测试用）：
go env -w GOPROXY=direct，看是否纯网络问题；调通后再切回https://goproxy.cn,direct - 注意：不要在
$GOPATH/src下初始化新模块 —— Go 1.16+ 默认禁用 GOPATH 模式，容易触发奇怪的路径冲突
go install gopls@latest 找不到 go.exe 或权限拒绝
这是编辑器（如 VS Code）提示 “gopls not found” 的典型原因，根源常不在 gopls 本身，而在环境链路断了。
立即学习“go语言免费学习笔记（深入）”；
- 先确认
GOBIN是否设置：运行go env GOBIN，若为空，建议显式设为%GOPATH%\bin（Windows）或$GOPATH/bin（macOS/Linux） -
go install默认把二进制扔进GOBIN，如果GOBIN没加进 PATH，终端就找不到生成的gopls - Windows 上若提示“拒绝访问”，可能是防病毒软件拦截了
go install写入%GOPATH%\bin，试试以管理员身份运行终端，或换到用户目录下设GOPATH - VS Code 中若仍报错，检查设置里
go.goroot是否指向真实GOROOT路径（不是GOPATH！），二者混淆是高频翻车点
GOPATH 和 GOROOT 的职责边界、GOBIN 是否纳入 PATH、代理是否真正落地生效——这三个点任一出错，都会让看似简单的命令行操作卡在“明明写了命令却没反应”上。 
