不能直接用go build编译出能在嵌入式路由器上运行的二进制，必须显式设置GOOS=linux、GOARCH=mipsle（小端）、GOMIPS=softfloat、CGO_ENABLED=0等参数，并预编译标准库，否则因字节序、浮点模式或动态链接不匹配导致exec format error或段错误。
不能直接用 go build 编译出能在嵌入式路由器上运行的二进制——默认参数生成的是大端、依赖完整 glibc 的可执行文件，而 OpenWrt 类设备普遍是小端 + musl libc，甚至无 libc（裸机），必须显式控制交叉编译参数。
确认目标设备真实架构，别信型号标称
很多路由器标“MIPS”，但实际是 mipsel（小端）或 mips64le；有些芯片还带软浮点（softfloat）或硬浮点（hardfloat）。不查清楚就编译，十有八九报 exec format error 或直接段错误。
- 登录路由器终端，运行
cat /proc/cpuinfo | grep -E "(cpu|byte)"，重点关注cpu model和Byte Order字段 - 若输出含
mipsel或little endian，必须用GOARCH=mipsle，不是mips - 若
cpu model含1004K、24KEc等，大概率是 softfloat，需加GOMIPS=softfloat - 运行
ldd ./your-binary（在路由器上）可验证是否动态链接、依赖哪个 ld —— 但前提是二进制能加载，否则先跳过
交叉编译必须关闭 CGO 并指定 musl 或裸机模式
Go 默认启用 CGO_ENABLED=1，会尝试链接系统 libc。嵌入式路由器要么用 musl，要么根本没 libc（如某些 uClibc 或 bare-metal 固件），强行链接只会报 no such file or directory（实际是找不到 /lib/ld-musl-mips-sf.so.1）。
- 强制静态链接：设置
CGO_ENABLED=0，这是最安全的选择 - 若必须用 C 代码（比如调用某个驱动 ioctl），则要配对安装
mips-linux-musl-gcc工具链，并设CC=mips-linux-musl-gcc、CGO_ENABLED=1 -
GOOS=linux是必须的——Go 不支持GOOS=openwrt或裸机 MIPS 目标，没有GOOS=freebsd/mips这类实现 - 示例命令：
GOOS=linux GOARCH=mipsle GOMIPS=softfloat CGO_ENABLED=0 go build -o router-app main.go
首次为新 GOARCH 编译前，预装标准库
Go 工具链不会自动为非本地 GOARCH 预编译 std 包。第一次 go build 可能卡在 cannot find package 'unsafe'，这不是代码问题，是 $GOROOT/pkg 下缺对应平台的归档文件。
立即学习“go语言免费学习笔记（深入）”；
- 不要手动复制或替换
$GOROOT/src或pkg目录——混用版本会导致不可逆损坏 - 确保
go version≥1.16（MIPS 支持从该版本起稳定） - 运行
go install std@latest（注意不是go build std），它会为当前GOOS/GOARCH组合预编译全部标准库 - 若提示
no required module provides package，说明 Go 版本太老或模块未启用，升级 Go 或在项目根目录运行go mod init dummy再试
验证二进制是否真能跑，别只看 flash 成功
tinygo flash 或 scp 传上去后显示“成功”，不代表程序会执行。TinyGo 的 flash 命令只写 Flash，不校验入口地址、中断向量表或 main 是否被正确链接；原生 Go 编译的二进制更不会自检目标 ld 路径。
- 先用
file router-app检查 ELF 架构：应显示MIPS (MSB/LSB)、statically linked、not stripped（便于后续调试） - 在路由器上运行前，加
chmod +x，再用./router-app &启动，立刻ps | grep router-app看进程是否存在 - 若崩溃，用
dmesg | tail -20查内核日志——常见原因是浮点模式不匹配（illegal instruction）或栈溢出（嵌入式内存小，避免大数组或递归） - 真正可靠的验证方式：在代码开头加一行
log.Println("start")并重定向到/tmp/log，比盲等 LED 闪烁靠谱得多
最容易被忽略的是浮点 ABI 和字节序的隐式耦合——GOARCH=mipsle 不等于自动适配 softfloat，必须显式加 GOMIPS=softfloat；而一旦设了，就不能在硬浮点芯片上运行。每次换设备，第一件事永远是查 /proc/cpuinfo，而不是改完参数就编译。
