Go跨平台交叉编译必须同时显式设置GOOS和GOARCH，缺一不可；且需关闭CGO_ENABLED=0以确保静态链接兼容性，否则易在目标机器报cannot execute binary file等错误。
go build 默认只生成当前系统的二进制文件。要跨平台编译，必须显式设置 GOOS 和 GOARCH，且两者缺一不可——这不是可选项，是硬性前提。
GOOS 和 GOARCH 必须成对出现，单独设置会出错
常见错误现象：build constraints exclude all Go files 或直接生成当前平台的文件，根本没生效。
-
GOOS=linux go build不行：GOARCH会沿用你本机值（比如arm64），但若目标服务器是amd64，就跑不起来 - 正确写法必须是：
GOOS=linux GOARCH=amd64 go build -o server main.go - Windows 用户在 PowerShell 中要用：
$env:GOOS="linux"; $env:GOARCH="amd64"; go build -o server main.go - 最安全、最推荐的写法（尤其 CI/CD）：
env GOOS=linux GOARCH=arm64 go build -o app-linux-arm64 main.go，避免污染当前 shell 环境
CGO_ENABLED=0 是大多数跨平台场景的默认安全开关
只要你的代码没调用 C 函数（比如没 import "C"、没用 github.com/mattn/go-sqlite3 这类含 cgo 的包），就该关掉 CGO。
-
CGO_ENABLED=0让二进制静态链接，不依赖目标机的 libc、glibc 或 MinGW，扔到 Alpine 容器或嵌入式 Linux 上也能直接跑 - 如果开了 CGO（
CGO_ENABLED=1），又在 macOS 上编译 Linux 版本，大概率报错：cannot find -lc或头文件缺失——因为你没有 Linux 的 C 工具链 - 例外情况：项目真依赖 SQLite、OpenSSL 或系统级图形库，就得在目标平台构建，或用 Docker 模拟：
docker run --rm -v $(pwd):/work -w /work golang:1.21-alpine go build -o app main.go
确认目标组合是否被当前 Go 版本支持
go tool dist list 输出的是你本地 Go 安装支持的所有 GOOS/GOARCH 对，不是“理论上存在”的所有组合。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- Go 1.21+ 才原生支持
windows/arm64；旧版本会报unsupported GOOS/GOARCH pair - M1/M2 Mac 编译
darwin/amd64（Intel Mac）没问题，但某些老 Go 版本（ - ARM 架构注意子版本：编译 ARMv7（如树莓派 3）需额外设
GOARM=7：GOOS=linux GOARCH=arm GOARM=7 go build -o pi-app main.go
生成的二进制不带配置文件、资源、动态库
这是最容易被忽略的一点：交叉编译只处理 Go 源码，其他全靠你手动打包。
立即学习“go语言免费学习笔记（深入）”；
- 如果程序读取同目录下的
config.yaml或templates/，这些文件不会自动打进二进制里 - 代码中别写死
"./config.yaml"，改用os.Executable()定位根路径，再拼接相对路径 - Windows 下生成的
.exe没图标、没 manifest，不是编译问题，是资源未嵌入——得用rsrc工具或第三方库注入
