GOOS和GOARCH必须严格匹配目标设备的真实运行环境，如树莓派Zero需GOARCH=arm+GOARM=6，树莓派4B应选GOARCH=arm64；GOOS=linux为嵌入式ARM设备通用值，GOARCH=arm64无需GOARM但依赖内核配置，CGO_ENABLED=1时须配目标C工具链与sysroot。
GOOS 和 GOARCH 必须匹配目标设备的真实运行环境
交叉编译不是“随便选个 arm 就能跑”，而是要严格对应设备上 Linux 内核的 ABI 和 CPU 指令集。比如树莓派 Zero（ARMv6）必须用 GOARCH=arm + GOARM=6，而树莓派 4B（ARMv8-A）应优先用 GOARCH=arm64；若误用 GOARCH=arm 编译出 32 位二进制，在 64 位内核上可能因缺少兼容层（如 armhf 用户空间支持）而报 exec format error。
-
GOOS=linux是绝大多数嵌入式 ARM 设备的固定值，除非你目标是裸机（bare metal）或 RTOS（此时需 TinyGo） -
GOARCH=arm仅适用于 ARMv6/v7，且必须配GOARM=6或GOARM=7；GOARM被废弃于 Go 1.21+，但旧设备（如某些工业 PLC）仍依赖它 -
GOARCH=arm64不需要GOARM，但要求设备内核启用CONFIG_ARM64_VA_BITS_48等关键配置，否则 mmap 可能失败
CGO_ENABLED=1 时，交叉编译器链必须与目标 rootfs 一致
一旦代码里用了 cgo（比如调用 libusb、sqlite3 或硬件 GPIO 库），Go 就不再静态链接——它会去调用目标平台的动态库。这时仅设 GOOS/GOARCH 不够，你还得让 Go 找到正确的 C 工具链和头文件。
- 必须设置
CC_arm或CC_arm64环境变量，例如CC_arm=arm-linux-gnueabihf-gcc，而非主机上的gcc -
CGO_CFLAGS需指向目标系统的sysroot，例如-I/opt/sysroot/usr/include；漏掉会导致编译期找不到stdint.h等基础头文件 -
CGO_LDFLAGS要包含-L/opt/sysroot/usr/lib，否则链接时提示undefined reference to `sqlite3_open' - 若目标系统无动态库（如精简版 Buildroot），应强制静态链接：
CGO_LDFLAGS="-static"，否则运行时报not found
Go 二进制在嵌入式设备上启动失败，先看 readelf -h 和 ldd
部署后执行报错，别急着改 Go 代码——先确认二进制本身是否适配。常见错误不是语法问题，而是 ELF 格式或依赖缺失。
- 在开发机上运行
readelf -h your_binary：检查Class（应为 ELF64）、Data（2's complement, little endian）、Machine（ARM 或 AArch64）是否与设备匹配 - 在目标设备上运行
ldd your_binary：若显示not a dynamic executable，说明是纯静态编译（正常）；若列出一堆=> not found，说明 CGO 动态链接失败 - 用
file your_binary确认是否含 interpreter（如/lib/ld-linux-armhf.so.3）——若路径不存在于设备，就得换 sysroot 或改静态链接
TinyGo 是 ESP32 等 MCU 的唯一可行路径
标准 Go 运行时无法塞进 ESP32 的 320KB SRAM，go build 直接报 runtime: out of memory。这不是配置问题，是架构限制——必须换工具链。
立即学习“go语言免费学习笔记（深入）”；
- TinyGo 不兼容标准
net/http，得用它自建的machine、device包操作 GPIO，HTTP 服务需基于tinygo.org/x/drivers/net -
tinygo flash命令直接烧录，不生成传统 ELF，而是生成 bin/uf2 固件；不能用scp部署，得走串口或 USB DFU - 不支持反射、大部分
unsafe操作、goroutine 数量硬限（默认 16），这些在main.go顶部加//go:tinygo注释也绕不过
GOARCH 对了，若你用 glibc 2.35 编译，而设备只装了 musl 1.2.3，./your_binary 仍会静默退出——连错误信息都不打。验证方式很简单：在设备上跑 cat /lib/libc.so.6 | head -n1（glibc）或 ls /lib/libc.musl-*（musl），再反向选配套的交叉工具链。 
