交叉编译必须同时指定GOOS和GOARCH且成对使用，缺一不可；CGO_ENABLED=0是避免依赖问题的默认安全选项，启用CGO需完整目标平台C工具链，验证须在目标环境或容器中运行。
交叉编译不是“选一个平台点一下”，而是必须同时指定 GOOS 和 GOARCH，缺一不可；CGO_ENABLED=0 是避免依赖爆炸和构建失败的默认安全线。
GOOS 和 GOARCH 必须成对出现，不能只设一个
常见错误是只写 GOOS=linux go build，结果生成的仍是当前机器架构（比如 macOS 上跑出 darwin/amd64 二进制），但文件名没后缀、运行报 Bad CPU type in executable。Go 不会帮你补全缺失项，也不会警告。
GOOS=linux GOARCH=arm64 go build -o app-linux-arm64 .-
GOOS=windows GOARCH=amd64 go build -o app.exe .（Windows 必须带.exe后缀） -
GOOS=darwin GOARCH=arm64 go build -o app-darwin-arm64 .（M1/M2 Mac） - 查所有合法组合：运行
go tool dist list，别凭经验猜GOOS=freebsd GOARCH=riscv64是否支持
CGO_ENABLED=0 不是可选项，是交叉编译事实标准
启用 CGO 时，go build 会尝试调用宿主机的 gcc、链接本地 libc 或 musl，而你在 macOS 上根本找不到 Windows 的 kernel32.lib，Linux 里也没有 Darwin 的 libSystem.dylib——直接报 exec: "gcc": executable file not found 或链接失败。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 纯 Go 程序（如只用
net/http、encoding/json）应始终加CGO_ENABLED=0 - 若用了
database/sql+ SQLite，需换驱动：github.com/ncruces/go-sqlite3（纯 Go 实现），原版mattn/go-sqlite3依赖 CGO - DNS 解析会自动降级到 Go 自带的
net实现（无/etc/resolv.conf也能工作，但不走系统 stub resolver） - 真要调 C 库（如 OpenSSL、CUDA），得配齐目标平台的完整交叉 C 工具链，复杂度远超 Go 本身
编译命令别用 export，用 env 前置更干净
在 shell 里 export GOOS=linux 后执行 go build，看似省事，实则埋雷：后续所有 go 命令都继承该变量，CI 脚本可能漏重置，Mac 用户尤其容易被 zsh 的环境继承行为坑到。
立即学习“go语言免费学习笔记（深入）”；
- 正确写法：
env GOOS=linux GOARCH=arm64 CGO_ENABLED=0 go build -o app . - PowerShell 用户注意：
$env:GOOS="linux"; $env:GOARCH="arm64"是会话级污染，改用cmd /c "set GOOS=linux && set GOARCH=arm64 && go build -o app ." - Windows cmd 下不要写
SETCGO_ENABLED=0（少空格），应为SET CGO_ENABLED=0 - 加
-a参数可强制忽略缓存：CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -a -o app .
生成的二进制只能在目标平台跑，别在宿主机双击或 ./ 尝试
你在 macOS 上执行 GOOS=linux GOARCH=arm64 go build，得到的 app 文件是 Linux ELF 格式，内核直接拒绝加载，报错 cannot execute binary file: Exec format error 或 zsh: bad CPU type in executable——这不是编译失败，是它压根就不是给你这台机器准备的。
- 验证方式只有两种：扔到目标机器上跑，或用容器模拟：
docker run --rm -v $(pwd):/work -w /work golang:alpine sh -c "GOOS=linux GOARCH=arm64 go build -o app-arm64 ." -
file app可快速确认格式：输出含ELF 64-bit LSB executable, ARM aarch64表示确实是 Linux ARM64；含Mach-O 64-bit executable x86_64才是 macOS Intel - Windows 上生成的
.exe没图标、没 manifest 是正常现象，不是编译问题，是资源未嵌入
