Go安装后go version报错是PATH未配置，需添加/usr/local/go/bin（Linux/macOS）或C:\Go\bin（Windows）；go build卡住因GOPROXY未设，应设为https://goproxy.cn,direct；构建慢多因缓存被禁或-gcflags调试参数滥用；交叉编译失败常因cgo启用导致libc不兼容，应设CGO_ENABLED=0。
go version 验证失败：PATH 没配对，不是没装
执行 go version 报 “command not found” 或 “无法识别命令”，大概率不是 Go 没装，而是 PATH 没把 /usr/local/go/bin（Linux/macOS）或 C:\Go\bin（Windows）加进去。尤其在手动解压安装后，这步最容易漏。
检查方式很简单：
- Linux/macOS 运行 echo $PATH，确认输出里含 /usr/local/go/bin；
- Windows 在 CMD 里运行 echo %PATH%，找有没有 C:\Go\bin。
- macOS/Linux：编辑
~/.zshrc（或~/.bash_profile），追加export PATH=$PATH:/usr/local/go/bin，再执行source ~/.zshrc - Windows：右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”中找到
Path，新增一行C:\Go\bin - 别用
sudo go version来“绕过”——那只是调用了 root 的 PATH，不能解决你日常开发的问题
go mod init 后 go build 失败：GOPROXY 没设，卡在拉包
新建项目跑 go mod init example.com/foo 没问题，但一执行 go build 就卡住、超时、报 cannot load ...: Get ...: dial tcp: i/o timeout，基本是 GOPROXY 没生效。
Go 1.13+ 默认启用 module，但国内直连 proxy.golang.org 不通，必须显式换源：
- 临时生效（当前终端）：
export GOPROXY=https://goproxy.cn,direct - 永久生效：运行
go env -w GOPROXY=https://goproxy.cn,direct（推荐，影响所有后续终端） - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct - 别写成
https://goproxy.io——该域名已停服，2025 年起返回 404
本地构建慢得离谱：缓存被禁、-gcflags 乱加
改一行代码就要等 8 秒才编译完？不是机器差，很可能是人为关了缓存，或调试参数污染了构建流程。
立即学习“go语言免费学习笔记（深入）”；
Go 默认开启构建缓存，但以下操作会绕过它：
- 用了
-a标志（强制重编所有依赖），日常开发完全不需要 - 设置了
GOCACHE=off或GOBUILDCACHE=0 - 在
go build里加了-gcflags="all=-N -l"——这是调试专用，关内联+关优化，编译快但二进制巨慢，且每次都会重编，别长期开着
提速建议：
- 检查缓存位置：
go env GOCACHE，确保路径可写（比如不是挂到只读 NFS） - 清理无效缓存只需
go clean -cache，别动-modcache，否则下次又要下一遍依赖 - 日常构建就用裸
go build，需要减体积再加-ldflags="-s -w"
交叉编译产物运行报错：GOOS/GOARCH 设错或 libc 不兼容
GOOS=linux GOARCH=arm64 go build -o app 编出来扔到树莓派上跑不了，报 no such file or directory，不是路径错了，而是动态链接问题。
Go 默认静态链接，但若项目 import 了 cgo（比如用 net 包解析 DNS、或调用 sqlite），就会依赖目标系统的 libc。这时候：
- 优先关闭 cgo：
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o app - 如果必须用 cgo（如需 OpenSSL），就得在目标平台或 Docker 里编译，不能靠 host 交叉编译
- macOS → Linux 交叉编译时，
GOOS=linux必须配CGO_ENABLED=0，否则生成的二进制仍含 macOS 特有符号 - 验证目标平台兼容性：
file app看架构，ldd app（Linux）或otool -L app（macOS）看依赖库
真正麻烦的从来不是装 Go，而是默认行为和本地习惯之间的错位——比如以为 go run 只是快捷方式，其实它也走缓存；比如以为 go mod tidy 是整理依赖，其实它会默默升级 minor 版本。留心这些隐含契约，比反复重装 SDK 有用得多。
