关键是要用 gvm 管理多个 Go 版本并隔离 GOROOT，通过 GOOS/GOARCH 控制交叉编译目标，CGO_ENABLED=0 实现静态链接，配合脚本批量构建多平台二进制。
Go 项目要同时支持多个 Go 版本、又得在一台机器上交叉编译出 Linux/macOS/Windows 二进制，关键不是“装多个 Go”，而是分清 GOROOT（Go 安装路径）和 GOPATH（老式工作区）的职责边界，并用 GOOS/GOARCH 控制输出目标 —— 后者不依赖本地系统环境，前者必须隔离干净。
怎么安全安装多个 Go 版本而不冲突
手动解压多个 Go 到不同目录再反复改 GOROOT 和 PATH，极易出错。推荐用 gvm 管理：
-
gvm install go1.21.6和gvm install go1.22.3会把各自版本装到~/.gvm/gos/go1.21.6这类路径下，互不干扰 - 进项目目录后执行
gvm use go1.21.6 --default，会在当前目录生成.gvmrc，下次cd进来自动切换 - 如果项目
go.mod里声明了go 1.22，但你硬切到go1.21.6，go build直接报错：go: cannot use go 1.21.6 with go 1.22 mod - Mac/Linux 下安装
gvm后，记得在~/.zshrc或~/.bashrc里补上：source ~/.gvm/scripts/gvm和export PATH="$HOME/.gvm/bin:$PATH"
为什么跨平台编译时总遇到 “exec format error”
这是最典型的运行时错误，说明你把 macOS 编译出的二进制直接扔到 Linux 上跑 —— 不是 Go 不跨平台，是你没控制好 GOOS 和 GOARCH：
- 在 macOS 上编译 Linux 版：必须显式设
GOOS=linux GOARCH=amd64（哪怕你 M1 芯片，目标服务器是 x86_64，就不能用arm64） - Windows 上命令语法不同：要用
SET GOOS=linux && SET GOARCH=amd64 && go build -o app，不能写成GOOS=linux GOARCH=amd64 go build -
go tool dist list可查所有合法组合，比如linux/amd64、darwin/arm64、windows/386，拼错一个字符就编译失败 - 加
-ldflags="-s -w"能减小体积，但不会影响可执行性；真正影响兼容的是CGO_ENABLED是否为0
CGO_ENABLED=0 是什么情况下必须加的
只要你的代码没调用 C 库（比如没用 net 包里的 DNS 解析、没连 SQLite、没调 OpenSSL），就该默认关掉 CGO：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
-
CGO_ENABLED=0强制静态链接，生成的二进制不含动态库依赖，扔到任意同架构 Linux 机器上就能跑 - 一旦开了
CGO_ENABLED=1，交叉编译就得配对应平台的 C 工具链（比如gcc-arm-linux-gnueabihf），复杂度陡增 - 常见踩坑点：本地开发时
CGO_ENABLED=1（默认），一到 CI 构建就忘加CGO_ENABLED=0，结果生成的 Linux 二进制在 Alpine 容器里报no such file or directory（缺 glibc） - 如果你非得用 cgo（比如调硬件驱动），建议用 Docker 构建：官方
golang:1.22-alpine镜像里预装了 musl 工具链，比手动配可靠得多
如何用一个脚本批量生成多平台二进制
手敲十几条 GOOS=xxx GOARCH=yyy 命令太累，写个 shell 脚本更稳：
#!/bin/bash
for os in linux darwin windows; do
for arch in amd64 arm64; do
if [[ "$os" == "windows" ]]; then
ext=".exe"
else
ext=""
fi
CGO_ENABLED=0 GOOS=$os GOARCH=$arch go build -ldflags="-s -w" -o "bin/app-$os-$arch$ext" main.go
done
done
注意三点：
- Windows 输出必须带
.exe后缀，否则双击打不开 -
-ldflags="-s -w"放在go build后面，顺序不能错 - 脚本里没写
GOARM（已废弃），也别用GO386这类旧变量，Go 1.20+ 只认GOOS/GOARCH
真正容易被忽略的是：跨平台构建前，务必确认 go.mod 和 go.sum 已提交，且所有依赖都通过 go mod verify 校验过 —— 否则不同机器拉的依赖版本可能不一致，编译结果看似成功，运行时却 panic。
