go version报错或找不到，必须确认三处：/usr/local/go/bin是否存在go文件；修改的是当前shell对应配置文件（如~/.bashrc）；source后需新开终端或执行exec $SHELL生效。
go version 命令报错或找不到，PATH 配置必须确认这三处
Linux 测试服务器上最常见的环境失效，就是 go 命令不可用。这不是安装失败，而是 PATH 没生效或写错位置。
- 检查
/usr/local/go/bin是否真实存在：运行ls /usr/local/go/bin，若无go文件，说明解压失败或路径不对 - 确认修改的是当前 shell 的配置文件：Ubuntu 默认用
~/.bashrc，CentOS 7+ 可能用~/.bash_profile；用echo $SHELL查看当前 shell 类型再决定改哪个文件 - 执行
source ~/.bashrc后，必须新开终端或运行exec $SHELL才能继承新环境，否则go version仍会提示 command not found
go build 编译产物无法在目标服务器运行，GOOS/GOARCH 必须显式指定
测试服务器通常是 x86_64 Linux，但你要部署的生产环境可能是 ARM64 或 Alpine 容器——直接 go build 出来的二进制默认绑定当前系统，不兼容。
- 交叉编译必须设两个环境变量：
GOOS=linux GOARCH=arm64 go build -o myapp-arm64 - 若目标是 Alpine（musl libc），需禁用 CGO：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp-alpine - 验证产物架构：用
file myapp-alpine看输出是否含statically linked和对应 arch 字样，避免运行时报not a dynamic executable或no such file or directory
go mod tidy 下载超时或失败，GOPROXY 不只是加速，而是必要配置
测试服务器往往没配代理或防火墙策略严格，go mod tidy 直连 goproxy.io 或 proxy.golang.org 极易卡住甚至失败，导致依赖无法解析。
- 必须设置国内镜像代理：
go env -w GOPROXY=https://goproxy.cn,direct - 若内网服务器完全离线，可先在有网机器
go mod download，再把$GOPATH/pkg/mod整个目录打包复制过去，最后go env -w GONOPROXY=your-internal-domain.com - 注意
go.mod中 replace 语句会绕过 GOPROXY，调试时可用go list -m all确认所有模块实际来源
Makefile 封装构建流程，避免手动敲重复命令出错
在测试服务器反复执行 go build、go test、go vet 容易漏参数或打错字，尤其涉及多平台输出时。
立即学习“go语言免费学习笔记（深入）”；
- 基础 Makefile 示例（保存为
Makefile）：
build-linux: export CGO_ENABLED := 0 build-linux: go build -o bin/app-linux-amd64 . build-arm64: export CGO_ENABLED := 0 build-arm64: export GOOS := linux build-arm64: export GOARCH := arm64 go build -o bin/app-linux-arm64 . check: go fmt ./... go vet ./... go test -v ./...
make build-arm64 即可一键产出 ARM64 静态二进制，无需记忆环境变量顺序export 必须写在 target 行下方、命令行上方，否则变量不生效；CGO_ENABLED=0 放在命令行前（如 CGO_ENABLED=0 go build）也有效，但不如 export 清晰CGO_ENABLED=0 和 GOPROXY 的组合效果——前者决定能否在无 libc 环境运行，后者决定能否顺利拉下依赖。两者缺一，打包就可能在上线那一刻才暴露问题。 
