必须配国内镜像因proxy.golang.org在国内被限流或拦截，导致go mod download超时或403错误；正确配置为go111module=on、goproxy=https://goproxy.cn,direct、gosumdb=sum.golang.org。
go env -w GOPROXY 为什么必须配国内镜像
不配代理，go mod download 会卡在 proxy.golang.org，超时后报错 module github.com/some/pkg: reading https://proxy.golang.org/...: 403 Forbidden 或直接连接失败。这不是网络问题，而是官方代理在国内被限流或拦截的常态。
真正起作用的是这三行（必须一次性执行）：
go env -w GO111MODULE=on<br>go env -w GOPROXY=https://goproxy.cn,direct<br>go env -w GOSUMDB=sum.golang.org
注意：direct 是 fallback 机制——当 goproxy.cn 找不到包时，自动回源到官方地址；GOSUMDB=sum.golang.org 不能设为 off，否则 go build 会拒绝校验 checksum，导致模块加载失败。
验证是否生效：
go env | findstr GOPROXY
输出应为：GOPROXY="https://goproxy.cn,direct"
CGO_ENABLED=0 是国产环境下的默认安全选项
国产操作系统（如统信UOS、麒麟Kylin）多数不预装 GCC 或 libc 兼容层，启用 CGO 会导致 go build 报错 exec: "gcc": executable file not found in $PATH，或链接阶段失败。
除非你明确需要调用 C 库（比如 OpenSSL、SQLite），否则一律设为 0：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o appCGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o app-arm64- Windows 下交叉编译也建议加，避免隐式依赖 mingw
副作用：无法使用 cgo 相关功能（如 net 包的 DNS 解析可能降级为纯 Go 实现，不影响基本功能）；但换来的是二进制纯净、零外部依赖、可直接部署。
GOOS 和 GOARCH 的国产平台对应关系要手动确认
国产系统本质仍是 Linux 内核，但发行版差异大。不要凭经验写 GOOS=linux 就完事——得看目标机器实际架构：
- 鲲鹏（TaiShan 服务器）→
GOARCH=arm64 - 飞腾（Phytium D2000）→
GOARCH=arm64（注意不是arm） - 海光（Hygon C86）→
GOARCH=amd64 - 兆芯（Zhaoxin KX-6000）→
GOARCH=amd64
查法很简单，在目标机器上运行：
uname -m
输出 aarch64 对应 arm64，x86_64 对应 amd64。别信“国产CPU就一定用arm”，海光/兆芯是 x86 兼容架构，必须用 amd64。
go build 输出二进制必须带 -ldflags="-s -w"
国产信创环境对二进制体积和符号信息有硬性要求：-s 去掉符号表，-w 去掉 DWARF 调试信息。不加这两个 flag，生成的文件可能被安全扫描工具标为“高风险”。
标准命令示例：
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -ldflags="-s -w" -o mysvc
效果显著：某 12MB 的服务程序，加 flag 后缩至 7.3MB，且通过等保三级静态扫描。
注意：-ldflags 必须紧贴 go build，不能写成 go build -ldflags "-s -w"（少个等号会失效）；也不能漏掉引号，否则 shell 会把空格当分隔符。
真正麻烦的不是参数组合，而是每次换平台都要重新验证 uname -m 和 ldd ./binary ——哪怕只是从麒麟V10 SP1 升级到 SP3，libc 版本微调也可能让没加 CGO_ENABLED=0 的二进制直接 segfault。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
