树莓派需先执行uname -m确认架构：armv7l选linux-armv6l（如go1.19.13.linux-armv6l.tar.gz），aarch64选linux-arm64（如go1.23.1.linux-arm64.tar.gz）；禁用apt安装，须官网下载、解压至/usr/local/go、显式设置GOROOT和PATH。
树莓派该下哪个 Go 安装包？看清楚架构再点下载
树莓派不是统一用 linux-armv7 或 arm64 就完事——得先确认你的系统架构，否则 go 命令直接报 cannot execute binary file: Exec format error。
执行这条命令看清楚：
uname -m
常见结果和对应安装包后缀：
-
armv7l（如树莓派 2/3/Zero W）→ 选linux-armv6l.tar.gz或linux-armv7.tar.gz（注意：Go 官网从 1.20 起已弃用armv6l，但树莓派 OS（32 位）仍需它；若找不到，go1.19.13.linux-armv6l.tar.gz是最后一个带完整支持的版本） -
aarch64（如树莓派 4/5 运行 64 位系统）→ 选linux-arm64.tar.gz
别去 apt install golang-go——Debian 源里是 go1.3.3 或 go1.19 等陈旧版本，go mod、go work 等现代功能缺失，且 GOROOT 路径混乱，交叉编译会失败。
立即学习“go语言免费学习笔记（深入）”；
官网下载链接怎么拼？别被重定向坑了
Go 官网 https://golang.org/dl/ 在国内常无法加载，但下载地址本身是稳定可预测的：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 所有官方 tar.gz 包都托管在
https://go.dev/dl/（这是当前唯一可靠入口） - 直接拼 URL：比如树莓派 4（64 位），要装
go1.22.5，就访问：https://go.dev/dl/go1.22.5.linux-arm64.tar.gz - 树莓派 3（32 位），用：
https://go.dev/dl/go1.19.13.linux-armv6l.tar.gz（这是 armv6l 最后一个 LTS 版本）
别信第三方镜像站打包的“树莓派专用版”——它们常私自改 GOROOT 或加 patch，go install 生成的二进制可能在其他 ARM 设备上跑不起来。
解压后 PATH 和 GOROOT 怎么设才不出错？
解压到 /usr/local/go 是硬性约定，不是建议：
- 必须运行：
sudo tar -C /usr/local -xzf go*.linux-arm*.tar.gz - 必须显式导出
GOROOT（哪怕它就在/usr/local/go）：export GOROOT=/usr/local/go -
PATH必须把$GOROOT/bin放最前：export PATH=$GOROOT/bin:$PATH（顺序错了，旧版go可能被优先调用）
验证是否生效：
go env GOROOT
输出必须是 /usr/local/go；如果为空或指向 /home/pi/go，说明 GOROOT 没生效，go build -buildmode=plugin 会直接失败。
为什么 go version 显示正常，但 go run 却报 missing $GOROOT/src？
这是树莓派用户高频踩坑点：你可能用了源码编译安装（比如从 GitHub clone go repo 自己 ./all.bash），但漏掉了 src 目录。
- 官方 tar.gz 包自带
src、pkg、bin，开箱即用 - 源码编译方式必须确保：
–GOROOT_BOOTSTRAP指向一个能跑的 Go 1.4+ 安装（树莓派上这步极慢且易失败）
– 编译完成后的~/go/src必须完整存在，且权限为普通用户可读 - 最简验证：
ls $GOROOT/src/runtime应列出一堆.go文件；如果报 “No such file or directory”，说明安装不完整，立刻删掉重来，别硬调
嵌入式场景下，go build -ldflags="-s -w" 减小体积、GOOS=linux GOARCH=arm64 交叉编译，都依赖 GOROOT/src 的完整性——这里出问题，后续所有构建都会静默失败或生成不可执行文件。
