树莓派本地编译需确保Go架构匹配（aarch64用linux-arm64包）、执行go mod init初始化模块、配置GOPROXY代理；交叉编译则须在开发机显式设GOOS=linux GOARCH=arm64且CGO_ENABLED=0，编译后用file验证ARM架构。
直接在树莓派上 go build 就能编译，但前提是 Go 二进制本身架构匹配、环境变量设对、模块初始化完成——漏掉任一环都会卡住或报错。
怎么确认树莓派上 Go 装对了架构
很多人 go run 失败，根本不是代码问题，而是下载了 linux-amd64 的 Go 包扔到树莓派上，执行时直接报 cannot execute binary file: Exec format error。
- 先跑
uname -m：输出aarch64→ 必须用linux-arm64.tar.gz；输出armv7l→ 用linux-armv7l.tar.gz（注意官网已不单独提供armv6l，旧 Pi Zero 可勉强用armv7l） - 别信
apt install golang：Debian 仓库里版本老旧（RPi OS 12 默认是 Go 1.19），且 runtime 编译目标可能混用armhf，导致cgo程序链接失败 - 验证方式：
go version输出里必须含linux/arm64或linux/arm，不能是linux/amd64
go build 前必须做这三件事
树莓派资源有限，go build 卡住、报 cannot find module 或反复超时，大概率是没走完基础准备。
- 项目根目录下先跑
go mod init example.com/myapp，生成go.mod—— 没这文件，go工具链会尝试联网解析导入路径，而树莓派 DNS 和带宽容易拖垮整个流程 - 国内用户立刻设代理：
go env -w GOPROXY=https://goproxy.cn,direct（goproxy.cn支持 ARM 架构缓存，比默认proxy.golang.org稳定得多） - 如果依赖私有库或网络极差，推荐在开发机上
go mod vendor，把整个vendor/目录传过去，再用go build -mod=vendor
交叉编译 vs 本地编译：什么时候该用哪个
你在 Mac / Windows 上写完代码，想编译好传到树莓派运行？必须交叉编译。但如果你已经在树莓派终端里敲 go build，就别加 GOOS 和 GOARCH —— 这反而会触发不必要的 cgo 链接逻辑，尤其当没装 gcc 时直接报 exec: "gcc": executable file not found。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 交叉编译命令（开发机上执行）：
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o myapp ./main.go；若必须用 cgo（比如调 SQLite），就得先在树莓派上装sudo apt install gcc libc6-dev，再在树莓派本机编译 - 本地编译（树莓派上执行）：
go build -o myapp ./main.go即可，无需任何环境变量；但要确保CGO_ENABLED=1时系统已装好 C 工具链 - 编译后用
file myapp检查：输出里必须有ARM aarch64或ARM，绝不能出现x86-64
CGO_ENABLED=0 是最省心的默认选项
只要你的程序不调用 C 库（比如不碰 SQLite、OpenSSL、硬件驱动），强制静态编译几乎没代价，还能绕开所有动态链接兼容性问题。
- 开启 CGO 后，Go 会链接系统
libc、libpthread，而不同发行版的 libc 版本和 ABI 差异会导致运行时报standard_init_linux.go:228: exec user process caused: no such file or directory—— 本质是动态链接器找不到 -
CGO_ENABLED=0生成的二进制体积略大（几 MB），但拷过去就能跑，不依赖外部共享库，也不挑树莓派 OS 版本（Bookworm/Bullseye） - 只有当你明确需要 cgo（如用
github.com/mattn/go-sqlite3）时，才关掉它，并接受额外的系统依赖管理成本
真正容易被忽略的是：交叉编译产物无法自动适配树莓派的硬件路径差异——比如 /sys/class/thermal/thermal_zone0/temp 在某些内核版本下是 thermal_zone1，GPIO 控制在 6.1+ 内核里已被 libgpiod 取代。这些不是编译问题，但会让“编译成功→运行失败”的排查变得模糊。
