GOOS和GOARCH必须显式指定，否则go build仅生成当前平台二进制；GOARM需配合ARM架构使用，CGO_ENABLED=0是静态编译前提，-ldflags="-s -w"可减小体积但丢失调试信息。
GOOS 和 GOARCH 必须显式指定，否则默认编译当前平台
不设 GOOS 和 GOARCH 时，go build 只生成本机可执行文件。Mac 上跑 go build main.go 得到的是 darwin/arm64，无法直接扔进 ARM Linux 设备里运行。
常见组合必须记牢：
-
GOOS=linux GOARCH=arm64：主流边缘设备（如树莓派 4、NVIDIA Jetson） -
GOOS=linux GOARCH=arm GOARM=5：老旧 ARMv5 设备（如部分 OpenWrt 路由器） -
GOOS=linux GOARCH=amd64：x86_64 服务器或工控机 -
GOOS=windows GOARCH=386：兼容老 WinXP/Win7 的 32 位环境
漏掉 GOARM 在 ARMv5 设备上会 panic：“exec format error”，因为默认生成 ARMv6+ 指令集。
CGO_ENABLED=0 是静态编译的前提，否则依赖 libc 动态链接
Go 默认启用 cgo，调用系统 libc；一旦目标平台没装 glibc 或 musl（比如 Alpine、BusyBox 环境），程序直接报错：standard_init_linux.go:228: exec user process caused: no such file or directory。
立即学习“go语言免费学习笔记（深入）”；
强制关闭 cgo 才能生成真正静态二进制：
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o agent main.go- 若代码里用了
net包（如 DNS 解析），关闭 cgo 后默认走纯 Go 实现，但会禁用getaddrinfo——某些内网 DNS 策略可能失效 - 若必须用系统 resolver，得保留 cgo 并交叉编译对应平台的 libc（极少见，通常绕开）
-ldflags="-s -w" 能砍掉 30%~50% 体积，但调试信息全丢
-s 去除符号表，-w 去除 DWARF 调试信息。对边缘设备特别关键——128MB 内存的工业网关，一个带调试信息的二进制可能多占 2~3MB。
实操注意点：
- 别在开发阶段加这俩 flag，否则
pprof、delve全失效 - CI/CD 流水线里才加：
go build -ldflags="-s -w" -o release/agent main.go - 若用 upx 压缩，必须先加
-s -w，否则 upx 会失败或解压后崩溃
Docker 构建时 TARGETOS/TARGETARCH 自动适配，但 builder 镜像得选对
多架构构建推荐用 BuildKit 的 --platform，但基础镜像必须支持目标平台。例如：
FROM --platform=linux/arm64 golang:1.21-alpine AS builder
如果写成 golang:1.21（非 alpine），Docker 默认拉 x86_64 镜像，即使指定了 --platform=linux/arm64，build 阶段仍可能因指令集不匹配失败。
安全起见，builder 镜像统一用 alpine 版，并确认其 tag 支持目标架构：
-
golang:1.21-alpine→ 支持linux/amd64、linux/arm64、linux/arm/v7 -
golang:1.21-slim→ 仅linux/amd64，不推荐用于跨平台 - ARMv5 设备需自建 builder（alpine 官方已不维护 arm/v5 镜像）
交叉编译不是“设了变量就完事”，每个环节都卡在细节上：GOARM 漏了、cgo 没关、镜像架构不匹配，任何一个都会让二进制在目标设备上直接拒绝执行。
