go version报错说明PATH未配置，Windows需重启终端，Linux/macOS需将/usr/local/go/bin加入PATH并source生效；go run报“cannot find module”是因未执行go mod init初始化模块；国内依赖需配置GOPROXY=https://goproxy.cn,direct。
go version 命令报错或无输出
说明 go 命令根本没进系统 PATH，不是版本问题，是路径没配对。Windows 上 .msi 安装后必须重启 CMD/PowerShell；Linux/macOS 手动解压的，/usr/local/go/bin 必须显式加进 PATH，且 source 生效后才能用。
- Windows 用户：安装完立刻关掉所有终端窗口再重开，否则
go version仍会提示“不是内部或外部命令” - Linux/macOS 用户：确认是否执行了
source ~/.bashrc（或~/.zshrc），且该文件里确实有export PATH=$PATH:/usr/local/go/bin - 检查
GOROOT是否被意外覆盖：运行go env GOROOT，输出应为/usr/local/go（Linux/macOS）或C:\Go（Windows 默认），为空或错误路径说明环境变量冲突
go run main.go 提示 “cannot find module for path”
这是 Go Modules 启用后的典型报错，不是代码写错了，是项目没初始化模块。Go 1.16+ 默认强制启用 Modules，go run 要求当前目录在 module 内，否则拒绝执行。
- 进入项目目录后，先运行
go mod init example.com/hello（模块名可任意，但需符合域名格式） - 如果已有
go.mod文件但路径不对，删掉它再重新go mod init - 不希望用 Modules？临时关闭：执行
go env -w GO111MODULE=off，但不推荐——现代生态（如gin、echo）全依赖 Modules
go build 编译出的二进制文件无法执行
常见于跨平台编译未指定目标 OS/ARCH，或 Windows 下生成的 .exe 被误放到 Linux 运行。Go 默认按当前系统编译，不会自动适配。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 想在 Linux 上编译 Windows 可执行文件？设环境变量：
GOOS=windows GOARCH=amd64 go build -o app.exe main.go - macOS M1/M2 机器默认
GOARCH=arm64，若要兼容 Intel 机器，加GOARCH=amd64 - Linux 下编译出的文件没有执行权限？用
chmod +x ./app补上，Windows 不需要这步
国内拉取依赖超时或失败
go get 或 go mod download 卡住、报 timeout 或 no matching versions，基本全是代理没配或配错。
立即学习“go语言免费学习笔记（深入）”；
- 必须执行这三条（永久生效）：
go env -w GO111MODULE=on、go env -w GOPROXY=https://goproxy.cn,direct、go env -w GOSUMDB=sum.golang.org - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct，不是https://proxy.golang.org - 某些私有仓库或公司内网模块需绕过代理：在
GOPROXY末尾加,https://intranet.example.com，或用go env -w GOPRIVATE=git.example.com
go、当前目录是不是 module、go build 是否针对目标平台、依赖能不能从国内镜像拉下来。其他都是锦上添花，这些没对，写再漂亮的代码也跑不起来。 
