根本原因是go run main.go不触发模块加载，必须用go run .并在项目根目录执行；需确保go111module=on、go.mod存在且路径规范，避免匿名模块导致依赖无法解析。
不用配 GOPATH、不用改环境变量、不手动设代理，Golang 环境也能开箱即用——前提是用对方式，且避开 CGO 和旧版模块陷阱。
go mod init 后为什么 still can't find package？
这不是环境没配好，而是模块模式下 go 命令默认只认当前目录有 go.mod 且路径符合模块名规范（如 github.com/user/repo）。常见错误现象：go run main.go 报错 cannot find module providing package，但 go build 却能过。
- 运行前先执行
go mod init example.com（随便起个合法域名即可，不真要解析） - 避免用
go run .或go run main.go直接跑单文件——它会临时创建匿名模块，无法解析相对路径导入 - 如果项目在
~/Desktop/myapp这类非标准路径，go mod init后再go run .才可靠 - 确认
go env GO111MODULE输出是on，不是auto；auto在 GOPATH 下会退化为老模式
CGO_ENABLED=0 不是万能钥匙，但多数场景必须加
启用 CGO 意味着编译时链接系统 C 库，这会导致跨平台二进制不可移植、体积膨胀、甚至在 Alpine 容器里直接崩溃。但有些包（如 net、os/user）在禁用 CGO 后行为会变——比如 DNS 解析回退到纯 Go 实现（慢但稳定），user.Current() 返回空用户。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 服务端程序、CLI 工具、容器镜像：一律设
CGO_ENABLED=0 - 需要调用 OpenSSL、SQLite、图像处理等 C 绑定时：必须开
CGO_ENABLED=1，并确保目标系统装对应 dev 包（如libssl-dev） - Mac 上交叉编译 Linux 时，即使不开 CGO，也要注意
GOOS=linux GOARCH=amd64—— M1 默认是arm64，编错架构连exec format error都不报，只提示No such file or directory
国内依赖拉取失败？别碰 GOPROXY=direct
GOPROXY=https://goproxy.cn,direct 是安全的，但很多人误写成 GOPROXY=https://goproxy.cn（缺 ,direct），结果一遇到私有模块或未同步的包就卡死。更隐蔽的问题是：某些企业内网会拦截 sum.golang.org 校验请求，导致 go get 失败并提示 checksum mismatch。
- 正确配置三行（Windows CMD 也适用）：
go env -w GO111MODULE=ongo env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=off（仅限内网无校验需求时） - 验证是否生效：
go env GOPROXY必须输出完整字符串，不含换行或空格 - 若仍超时，检查是否被公司代理重定向——可临时加
-v参数看go get -v的真实请求地址
一键编译发布脚本里最容易漏掉的两件事
写完 build.sh 或 GitHub Action YAML，测试通过就提交？等等——Linux 服务器上 ./app 权限不够、Windows 编译出的 .exe 在 Mac 上双击没反应，这些都不是“环境问题”，是发布链路断点。
- Linux/macOS 产出的二进制默认无执行权限，脚本末尾加
chmod +x ./app - Windows 编译需显式加
.exe后缀：go build -o app.exe，否则生成的是无后缀文件，双击无效 - 用
-ldflags="-s -w"去符号和调试信息，能减小 30%+ 体积，但会丢失 panic 时的行号——上线前权衡是否保留 - 版本信息硬编码进二进制？用
-ldflags="-X main.version=$(git describe --tags)"，但确保工作区干净或加--always
跨平台编译真正的复杂点不在命令本身，而在于你是否清楚自己依赖了什么——net/http 没问题，os/exec 也没问题，但一旦用了 cgo 或 syscall 相关封装，那个 CGO_ENABLED=0 就不再是可选项了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
