必须根据uname -m输出选择对应Go二进制包：aarch64选arm64包，armv7l需降级至Go 1.19用armv7包或改用64位系统，armv6l仅支持Go 1.16及更早armv6包；禁用apt安装，避免ABI不兼容导致cgo失败或exec format error。
怎么选对 Go 二进制包，避免 cannot execute binary file: Exec format error
树莓派不是统一架构，装错包直接报错。关键看 uname -m 输出：
-
aarch64→ 必须用go1.xx.linux-arm64.tar.gz（树莓派 4/5 刷 64 位系统时） -
armv7l→ 用go1.xx.linux-armv7.tar.gz（注意：Go 官网从 1.20 起已不提供 armv7 包，得降级到 1.19 或改用 arm64 系统） -
armv6l→ 只能用go1.16.linux-armv6l.tar.gz或更老版本（树莓派 Zero / 1 / 2B）
别信“armv7 兼容 armv6”这种模糊说法——Go 二进制是静态链接的，架构不匹配就是硬失败。官网包列表里没有 armv7 就别硬试，容易卡在解压后 go version 报错。
为什么别用 apt install golang？
Debian/Ubuntu 仓库里的 golang 包普遍老旧（如 RPi OS 12 自带 go1.19），且编译时用了 armhf 工具链，导致两个典型问题：
- cgo 程序编译失败，错误里完全不提缺
gcc，只报exec: "gcc": executable file not found in $PATH -
go build生成的二进制在本机跑不了，因为 runtime 是用不同 ABI 编译的
正确做法是删掉 apt 安装的 go：sudo apt remove golang-go，再手动解压官方包。尤其别混用 apt 和 tar 包——/usr/bin/go 和 /usr/local/go/bin/go 冲突时，PATH 顺序决定你实际用的是哪个。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
sudo tar -C /usr/local -xzf 解压后 PATH 怎么配才生效？
解压本身很简单，但 PATH 配错就找不到 go 命令。重点不是“加没加”，而是“加给谁读”：
- 用
~/.bashrc？那得确认你用的是 bash —— RPi OS 默认 shell 是 bash，但如果你装过 zsh，就得改~/.zshrc - 写进
/etc/environment？它不解析$PATH变量，只能写死路径，且非登录 shell（比如 VS Code 终端）可能不加载 - 必须写成：
export PATH=/usr/local/go/bin:$PATH，不是GOBIN（那是go install输出目录）
配完立刻验证：source ~/.bashrc && go version。如果还报 command not found，运行 echo $SHELL 看真实 shell，再查对应配置文件。
模块下载慢、go mod download 卡住或超时怎么办？
树莓派本身 DNS 解析弱、带宽小，加上默认代理 proxy.golang.org 国内不稳定，很容易卡在 verifying 阶段。直接设国内代理最有效：
-
go env -w GOPROXY=https://goproxy.cn,direct（推荐，支持私有模块 fallback） - 若公司用私有 GitLab，加：
go env -w GOPRIVATE=gitlab.example.com/myteam/* - 别设
GOPROXY=off—— 这会让 go mod 直连 GitHub，失败率更高
注意：GOPROXY 和 GOPRIVATE 必须同时配好，否则私有模块会走代理然后 404；而 cgo 启用状态、系统头文件（libc6-dev）、GCC 是否安装，这三个点才是后续编译失败的真正高发区，比安装步骤本身更值得盯紧。
