go111module必须设为on，因auto在ci/cd或容器中易退化为off导致构建失败；goproxy需配国内镜像加,direct fallback；goroot/gopath无需手动设，但path须含goroot/bin；云原生构建必加-go build -ldflags="-s -w"。
GO111MODULE 必须设为 on，不能依赖 auto
本地开发时 auto 看似省事，但 CI/CD 流水线或容器构建中，go.mod 文件可能尚未存在或路径不一致，auto 会退化为 off，导致 go build 忽略模块声明、拉取旧版依赖甚至编译失败。
实操建议：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 全局启用：
go env -w GO111MODULE=on - 项目根目录下必须有
go.mod（用go mod init example.com/service初始化） - 禁止在 Makefile 或 CI 脚本里临时改
GO111MODULE—— 它是构建语义的一部分，不是开关
GOPROXY 要配国内镜像且带 fallback
官方代理 https://proxy.golang.org 在国内多数环境无法稳定访问，直接导致 go mod download 卡住或超时，错误信息通常是 Get "https://proxy.golang.org/...": dial tcp: i/o timeout。
实操建议：
- 推荐配置：
go env -w GOPROXY=https://goproxy.cn,direct -
direct是关键：它让私有仓库（如公司内网 GitLab）绕过代理，否则会 404 - 若企业用 Nexus 或 Artifactory，把
https://goproxy.cn替换为对应地址，仍保留,direct - 不要只写一个代理地址 —— 单点故障会导致整个构建中断
GOROOT 和 GOPATH 不再需要手动设，但 PATH 必须包含 GOROOT/bin
Go 1.16+ 安装包已自带 GOROOT 推导逻辑，手动设置反而容易出错（比如指向旧版本目录），而 GO111MODULE=on 后 GOPATH 对依赖管理已无实质影响。
实操建议：
- Windows：确认安装路径是
C:\Program Files\Go，PATH 中加%GOROOT%\bin（安装程序通常自动完成） - macOS/Linux：检查
which go输出是否为/usr/local/go/bin/go；如果不是，删掉旧的export GOPATH=...行，只留export PATH=/usr/local/go/bin:$PATH -
go env GOROOT应输出实际路径，若为空或错误，说明 PATH 里的go不是官方二进制
云原生场景下，go build 必须加 -ldflags="-s -w"
默认编译产物含调试符号和 DWARF 信息，镜像体积多出 2–5MB，且暴露函数名、文件路径等敏感信息，不符合云原生“最小攻击面”原则。
实操建议：
- 构建命令统一用：
go build -ldflags="-s -w" -o ./bin/app ./cmd/main.go -
-s去除符号表，-w去除 DWARF 调试信息 - CI/CD 中若用
go test -c，同样要加该参数，否则测试二进制也带符号 - 别用
upx等压缩工具 —— 它可能破坏静态链接，且部分安全扫描工具会告警
GO111MODULE、GOPROXY、PATH）必须在容器构建阶段就生效，而不是仅在本地 shell 里设好。Dockerfile 中的 RUN go mod download 看似简单，一旦环境变量没透传进去，就会回退到不可控状态。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
