先说一句，这玩意儿真的很麻烦，特别是你又不是程序员，只是想在树莓派上跑个小网站。下面的东西都是我自己折腾出来的，可能有错，有对，也可能根本不对。反正我也不想太正经，就随便写写，别怪我太“烂”。

一、 先选对Go版本——别乱装

Go 从 1.17 开始正式把 arm64 当成一级平台来支持，所有官方发布的 go1.17 整一个... + 二进制包里都有 linux/arm64 和 darwin/arm64 的产物。但是要记住：

• arm 在 Go 1.20 前才有点儿影子， 到了 1.21+ 官方直接说 “没了”，只能自己编译或者找第三方镜像。
• 一定要对应系统位数和CPU架构。
• 别忘了检查下载链接是不是被墙了用国内镜像会快点。

挽救一下。 噪声提示：如果你看到下载页面里写着 “amd64”， 那肯定是给 x86_64 用的，你这 ARM 小板子根本跑不了。

二、 环境变量随意乱配——常见坑点

$PATH, $GOROOT, $GOPATH, $GOARCH, $GOOS. 把这些玩意儿弄错，你会发现终端直接报 “command not found”。最常见的错误就是：，掉链子。

export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
# OOPS! 少了一个 $ 符号
export GOARCH=arm
export GOOS=linux

纠正：

export GOARCH=arm64   # 对于树莓派4或者其他aarch64设备
# 或者如果真的是32位板子:
# export GOARCH=arm
# 并且一定要配合 GOARM=7 
export GOARM=7

三、 交叉编译 VS 本地编译——别把自己逼疯了

很多人喜欢在自己的 x86_64 主机上直接跑交叉编译指令，却忘记设好正确的变量。比如下面这句：，我悟了。

GOOS=linux GOARCH=arm go build -o hello-arm file.go

⚠️ 错误！如果目标是 arm64，这里应该是 arm64；如果是 32 位 arm，还得加上 GOARM。

正确示例：

GOOS=linux GOARCH=arm64 go build -o hello-arm64 file.go   # aarch64
# 或者：
GOOS=linux GOARCH=arm GOARM=7 go build -o hello-arm7 file.go   # armv7

四、CGO 的坑——别盲目关掉它！

Cgo 是 Go 调用 C 库的桥梁，大多数网络库、数据库驱动都依赖它。如果你随手写上：

CGO_ENABLED=0 go build ...

⚠️ 那么 DNS 会退化为纯 Go 实现， os/user 查不到用户名，SQLite、MySQL 等驱动根本不可用，不妨...。

但是另一方面 大多数轻量级 ARM 系统默认不带完整 GCC 工具链，一打开 CGO 就报错：“cannot find gcc”. 所以最靠谱的办法是：，本质上...

• 装完整的 gcc + make + pkg-config。
• If you use Alpine:
• # apk add build-base pkgconfig libc-dev openssl-dev

If you use Debian/Ubuntu:，绝绝子...

• # apt-get update && apt-get install -y build-essential pkg-config libssl-dev

\end{itemize}

Cgo 路径问题常被忽略

Cgo 在链接系统库时会去找 pkg-config 配置文件。如果路径不对，就会出现类似 “package openssl not found” 的错误。解决办法很简单：，来日方长。

export PKG_CONFIG_PATH=/usr/lib/aarch64-linux-gnu/pkgconfig:/usr/lib/pkgconfig
# 有时候还得加上 /usr/local/lib/pkgconfig 
# 看看实际目录到底在哪儿，用 find / -name openssl.pc 来定位。

五、其他小细节

LDD 检查二进制依赖： 编译完后运行 # ldd ./hello-arm64 not a dynamic executable # 表示纯静态链接 或者显示缺少 libssl.so.x.x ... 那就说明 cgo 链接失败。 NTP 同步时间： ARM 板子时间经常漂移， 如果系统时间不准，一些 TLS 握手会直接挂掉。建议装个 ntpd 或者使用 timedatectl sync。 .profile vs .bashrc vs .zshrc： 环境变量放错文件导致登录 shell 生效但非登录 shell 不生效。最保险的做法是把关键变量写进 /etc/profile.d/go.sh。 MIPS vs ARM 混淆： 有些国产板子自称 “Arm”， 但其实吧内部芯片是 MIPS 或者 RISC-V，这种情况下任何 arm 编译包都会报错 “invalid ELF header”。买板子前一定要确认 CPU 架构！ \end{ul}，推倒重来。

六、 调试技巧——鸡肋但有时候有用

打开 GDB 调试： 安装 gdb-multiarch，然后施行 # gdb-multiarch ./hello-arm64 在 gdb 提示符下输入 set architecture aarch64 再 run。 \item 使用 strace 捕获系统调用： # strace -f -o log.txt ./hello-arm64 看看到底卡在哪一步。 ` \end{ol}，试着...

七、 ——再烂也要有个

与君共勉。 在 ARM 上搞 Go 环境需要注意以下几点：

选对 Go 版本和对应 arch 。 确认系统里有完整 C 编译链。 合理设置环境变量， 特别是 $PATH、$GOROOT、$GOPATH、$GOARCH、$GOOS。 CGO 必须根据需求开启或关闭，并确保 pkg-config 路径正确。 内卷... 交叉编译时一定要匹配目标 CPU 的指令集 。 调试时善用 ldd、strace、gdb。 别忘了时间同步和系统库依赖。 再说说如果实在搞不定，就考虑直接搬官方 Docker 镜像跑容器——省事！

声明：本文故意使用口语化、 不规范的表达方式，仅供娱乐学习参考。如需正式文档，请参阅官方 Golang 文档或专业书籍。本页面内容未经严格校对，请自行甄别风险。