能直接装，但必须选对架构包、避开 apt 旧版本、绕开 gopath 陷阱——树莓派上 go 环境的核心矛盾从来不是“能不能跑”，而是“cgo 能不能编、模块能不能下、path 到底生效没”。
查清系统架构再下载，别碰 apt install golang
树莓派 4/5 推荐刷 Raspberry Pi OS (64-bit)，运行 uname -m 输出 aarch64 → 下载 go1.xx.linux-arm64.tar.gz；若仍是 32 位系统（armv7l），可试 armv7 包，但注意 Go 官网已不提供 armv6 独立包，树莓派 2B/3B 必须降级到 go1.16 或硬用 armv7 包（部分 cgo 场景会失败）。
绝对不要 sudo apt install golang：Raspberry Pi OS 仓库中 Go 版本普遍滞后（如 1.19），且 runtime 编译目标混用 armhf，导致 cgo 启用时链接失败，错误里却只报 undefined reference to 'clock_gettime' 这类误导信息。
/usr/local/go + PATH 配置必须精准，别改 /etc/environment
解压命令必须是：sudo tar -C /usr/local -xzf go1.xx.linux-arm64.tar.gz。路径写死在 /usr/local/go 是惯例，放 /opt 或家目录会导致后续工具链识别异常。
环境变量只加一行：export PATH=/usr/local/go/bin:$PATH，追加到 ~/.bashrc（bash 用户）或 ~/.zshrc（zsh 用户），千万别写进 /etc/environment —— 它不支持 $PATH 展开，会导致非登录 shell（如 VS Code 终端、systemd service）根本找不到 go 命令。
生效后务必验证：source ~/.bashrc && go version，如果仍提示 command not found，先检查 shell 类型：echo $SHELL，再确认改的是对应配置文件。
GOOS/GOARCH 交叉编译在树莓派本机开发中纯属干扰项
你在树莓派上写代码、编译、运行，目标就是本地平台——GOOS=linux GOARCH=arm64 是给 x86 电脑编译树莓派程序用的，本机开发时设了反而触发 cgo 链接器误判，尤其当你用 sqlite3 或 openssl 时，会报 exec: "aarch64-linux-gnu-gcc": executable file not found。
真正要装的是系统级编译工具：sudo apt install build-essential libc6-dev。缺这个，go build 卡在 “cannot find package "C"” 或静默失败，错误日志里根本不会提 gcc 缺失。
GOPROXY 和 cgo 头文件缺失才是真瓶颈
go mod download 卡住？不是网络慢，是默认代理 proxy.golang.org 在树莓派上 DNS 解析失败 + 模块索引体积大。必须立刻设置：go env -w GOPROXY=https://goproxy.cn,direct（国内推荐）或 https://goproxy.io,direct。
私有模块（如 GitLab 内部库）要额外加：go env -w GOPRIVATE=gitlab.example.com/myteam/*，否则代理会跳过，又回到直连超时。
cgo 相关错误（比如 fatal error: sqlite3.h: No such file or directory）本质是系统头文件缺失，不是 Go 配置问题：sudo apt install libsqlite3-dev libssl-dev 才是解法，而不是调 CGO_ENABLED 或改 CC。
最易被忽略的是：树莓派上 Go 环境的稳定性不取决于安装步骤是否完整，而取决于 cgo 是否启用、GCC 是否可用、GOPROXY 是否绕过 DNS 和带宽限制——这三个点任意一个断掉，go build 就会以不同面目报错，且错误信息从不直说根源。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
