必须设GO111MODULE=on且GOPROXY=https://goproxy.cn,direct，否则go build因模块未启用或代理失败而报“cannot find module providing package”。
go version 能跑，但 go build 报错找不到包？检查 GOPROXY 和 GO111MODULE
很多新手在 Windows 上装完 Go，go version 显示正常，一执行 go build 就报 cannot find module providing package xxx，根本原因是模块机制没启用或代理不可用。
-
GO111MODULE必须设为on（Go 1.16+ 默认开启，但旧版或某些 MSI 安装可能未生效） -
GOPROXY推荐设为https://goproxy.cn,direct，国内直连proxy.golang.org基本失败 - PowerShell 临时设置：
$env:GO111MODULE="on"; $env:GOPROXY="https://goproxy.cn,direct" - 永久生效需用
setx /m（管理员权限）或改注册表，普通setx只对新窗口生效 - 验证是否生效：
go env GO111MODULE GOPROXY输出应为on和对应地址
交叉编译时生成的 .exe 在 Linux 上打不开？确认 GOOS/GOARCH 组合合法
常见错误是直接套用 GOOS=linux GOARCH=amd64 go build，结果在目标机器上提示 cannot execute binary file: Exec format error——本质是架构不匹配，或遗漏了 CGO 相关配置。
- Windows 主机编译 Linux 二进制：必须设
CGO_ENABLED=0，否则默认链接 Windows 动态库，无法在 Linux 运行 - 合法组合参考：
GOOS=linux GOARCH=amd64、GOOS=darwin GOARCH=arm64、GOOS=windows GOARCH=386；GOARCH=arm64在 macOS 上需搭配GOOS=darwin，不能混用GOOS=linux - 命令示例：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o app-linux main.go - 验证产物：
file app-linux（Linux/macOS）或用strings app-linux | head -n5看是否有 ELF 头，避免误生成 Windows PE 文件
go mod init 后 go.sum 为空或校验失败？GOSUMDB 配置影响依赖可信度
执行 go mod init 后，go build 或 go mod download 卡住、报 verifying github.com/xxx@v1.2.3: checksum mismatch，大概率是校验服务器不可达或被拦截。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
GOSUMDB默认为sum.golang.org，国内访问极不稳定；可设为off（跳过校验，仅开发测试用）或sum.golang.google.cn（官方国内镜像） - 安全建议：生产环境不要设
GOSUMDB=off，优先尝试https://goproxy.cn+sum.golang.google.cn组合 - 设置方式：
go env -w GOSUMDB=sum.golang.google.cn - 重置校验缓存：
go clean -modcache再重新go mod download
同一份代码，在不同平台编译后体积差异巨大？静态链接与 CGO 是关键变量
比如 Windows 编译出 12MB 的 app.exe，Linux 编译出 4MB 的 app，不是代码问题，而是默认链接行为不同。
立即学习“go语言免费学习笔记（深入）”；
-
CGO_ENABLED=1（默认）：Go 会链接系统 C 库（如 musl/glibc），体积小但依赖宿主环境；CGO_ENABLED=0：纯静态链接，体积略大但无外部依赖 - Windows 默认
CGO_ENABLED=1，但实际可用 C 工具链少，常退化为静态链接，导致体积偏大 - 减小体积技巧：
go build -ldflags "-s -w" -o app main.go（去掉调试信息和符号表） - 真正跨平台一致：统一用
CGO_ENABLED=0编译所有目标平台，再配合-ldflags "-s -w"
CGO_ENABLED、GOPROXY、GOSUMDB 这三个环境变量只要一个配错，就会卡在下载、校验或运行阶段。尤其 CGO_ENABLED=0 容易被忽略，却直接决定产物能否脱离原生环境运行。 
