根本原因是PATH未包含Go的bin目录，需确认安装路径、匹配shell类型、编辑配置文件添加PATH并source生效；GOROOT、GO111MODULE、GOPROXY也须正确配置。
报错不是环境没装好，而是几个关键路径和开关没对齐——PATH、GOROOT、GO111MODULE 和 GOPROXY 四者中只要一个错位，go 命令就会在不同阶段突然失败。
go command not found：PATH 里根本没挂上 bin 目录
这不是重装能解决的问题。系统找不到 go，99% 是因为 $GOROOT/bin（比如 /usr/local/go/bin 或 C:\Go\bin）压根没进 PATH，或者进了但终端没刷新。
- 先确认二进制是否存在：
ls /usr/local/go/bin/go（macOS/Linux）或dir C:\Go\bin\go.exe（Windows） - 检查当前
PATH是否含 Go 路径：echo $PATH | grep go（macOS/Linux）或$env:PATH -split ";" | Select-String "Go"（PowerShell） - 改完配置必须
source ~/.zshrc（Zsh）或重启 PowerShell——旧窗口不会自动更新PATH - 别把
$GOROOT/bin放在PATH末尾，否则可能被旧版 Go 或系统自带的go覆盖
go mod init 卡住或报 x509 错误：GOPROXY 没生效或被绕过
模块初始化要连 proxy.golang.org，国内直连必超时；错误里带 x509: certificate signed by unknown authority 或 dial tcp: i/o timeout，基本就是代理没起作用。
- 强制启用模块模式：
go env -w GO111MODULE=on（别信auto，它会在$GOPATH/src下退化） - 设国内可用代理：
go env -w GOPROXY=https://goproxy.cn,direct - 私有域名必须显式声明：
go env -w GOPRIVATE=git.internal.company.com/*，否则 fallback 到公共 proxy 就会失败 - 验证是否落地：
go env GOPROXY输出应与设置一致，且curl -I https://goproxy.cn/github.com/golang/example/@v/v0.0.0-20240222150851-9f7e5c59b1ff.info返回 200
go run 能跑，go build 出来的二进制一运行就 panic：不在模块根目录构建
这个错常被当成环境问题，其实是构建上下文丢失——go build 需要读 go.mod 来解析 embed、build info 等元数据，一旦 cwd 不是模块根，就会 panic “failed to initialize module”。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 执行
go build前，先确认go env GOMOD输出的是真实go.mod路径，不是空字符串 - 项目结构如
project/cmd/myapp/main.go，构建命令必须在project/目录下运行：go build -o myapp ./cmd/myapp - CI 脚本里容易忽略工作目录，建议开头加
cd "$(dirname "$(realpath "$0")")/.."切到模块根 -
go run main.go可以不依赖模块根（它自己推导），但go build和go install严格要求
go install 的工具命令找不到：GOBIN 没进 PATH 或权限不对
go install 默认把二进制写进 $GOBIN，如果 $GOBIN 不在 PATH 里，或者目录不可写，就会装了也用不了。
- 确保
$GOBIN目录存在且属当前用户：mkdir -p $HOME/go/bin+chown -R $(whoami) $HOME/go - 导出时把
$GOBIN放PATH开头：export PATH=$GOBIN:$PATH - 装完验证位置：
which gopls（macOS/Linux）或where gopls（PowerShell）输出应落在$GOBIN下 - 别用
sudo go install，否则二进制归 root，普通用户运行时报 permission denied
最易被忽略的是：GOROOT 写错成项目路径或 $HOME/go，会导致标准库版本错乱——现象是 import "fmt" 都失败，但错误信息完全不提 GOROOT，排查时得先看 go env GOROOT 输出是否真实指向安装目录。
