能直接装官方二进制包，但必须和系统架构严丝合缝——装错会报 cannot execute binary file: Exec format error，不是权限问题，是根本跑不起来。
能直接装官方二进制包，但必须和系统架构严丝合缝——装错会报 cannot execute binary file: Exec format error，不是权限问题，是根本跑不起来。
查清你的树莓派到底跑什么架构
别猜，直接终端敲：uname -m。输出是 aarch64？说明你用的是 64 位系统（推荐刷 Raspberry Pi OS (64-bit)），该下 go1.xx.linux-arm64.tar.gz；输出是 armv7l 或 armv6l？那就是 32 位系统，得选 armv7 包（armv6 已被 Go 官网弃用，1.17+ 不再提供，硬要用就得降级到 Go 1.16）。
常见误区：
- 看到“树莓派 4B”就默认 arm64 —— 实际可能还跑着旧版 32 位系统
- 用
apt install golang图省事 —— Debian 仓库版本老旧（如 RPi OS 12 默认 1.19），且 runtime 编译目标混为 armhf，cgo 程序一编译就跪
解压路径和 PATH 配置必须按惯例来
解压命令必须带 -C /usr/local：sudo tar -C /usr/local -xzf go1.xx.linux-arm64.tar.gz。别放 /opt、别放家目录、别用 sudo tar -xzf 解到当前目录再挪 —— 后续 PATH 和 GOROOT 逻辑全乱。
立即学习“go语言免费学习笔记（深入）”；
PATH 加载要对人：在 ~/.bashrc 末尾加 export PATH=/usr/local/go/bin:$PATH，然后 source ~/.bashrc；如果你用的是 zsh（比如 VS Code 终端默认就是），得改 ~/.zshrc，否则 go version 永远提示 command not found。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
注意：GOBIN 是给 go install 指输出路径的，不是用来让 go 命令本身生效的 —— 这个混淆点导致很多人反复折腾环境变量却无效。
cgo 和系统依赖不装，go build 会静默失败
只要代码里 import 了 "net/http"、"database/sql" 或任何带 C 依赖的包（比如 SQLite、OpenSSL），就必须先装系统级工具链：
-
sudo apt update && sudo apt install -y build-essential（含 gcc、libc6-dev） - 否则
go build报错像exec: "gcc": executable file not found in $PATH或卡在# runtime/cgo，错误信息里根本不提缺什么 - 交叉编译没必要：你在树莓派上本机开发，
GOOS/GOARCH默认就是本地目标，硬设反而触发 cgo 链接器 bug
模块下载慢或超时，核心是代理没设对
go mod download 卡住、验证失败、超时，90% 是因为没设国内代理。官方 proxy.golang.org 在树莓派上 DNS 解析慢 + 带宽低 + 模块索引体积大，三重叠加直接瘫痪。
执行这条命令即可生效：go env -w GOPROXY=https://goproxy.cn,direct（goproxy.cn 对国内网络更稳，比 goproxy.io 更可靠）。
如果项目用私有 GitLab/内部模块，还得补一句：go env -w GOPRIVATE=gitlab.example.com/myteam/*，否则私有域名会被代理强制转发，404 或认证失败。
最麻烦的从来不是装不上，而是 cgo 启用状态、头文件缺失、模块代理和私有域名配置混在一起 —— 错一个，go run 就给你甩个似是而非的错误，得一个个排除。
