go语言多平台编译必须同时显式设置goos和goarch，缺一不可；cgo_enabled=0是稳定生成静态二进制的前提，否则易因c库不兼容导致构建失败或运行时报错。
Go 语言没有“框架编译”这回事 —— 所谓多平台发布，就是用 go build 配合 GOOS 和 GOARCH 生成目标平台的二进制文件，不依赖框架、不打包源码、也不上传到中心仓库。
go build 跨平台编译必须设 GOOS 和 GOARCH
不设环境变量时，go build 默认只编译当前系统平台。想发给 Linux 用户，就得显式指定：
GOOS=linux GOARCH=amd64 go build -o myapp-linux ./cmd/myappGOOS=windows GOARCH=amd64 go build -o myapp.exe ./cmd/myappGOOS=darwin GOARCH=arm64 go build -o myapp-macos ./cmd/myapp
注意：GOOS=windows 会自动加 .exe 后缀（即使命令里没写），而其他平台不会自动加后缀；./cmd/myapp 必须包含 main.go 且包名为 main，否则报 no Go files in 错误。
CGO_ENABLED=0 是跨平台稳定的前提
只要项目里用了 net、os/user、sqlite 等默认启用 cgo 的包，交叉编译就大概率失败或生成不可移植的二进制。常见现象包括：
- Windows 上编译 Linux 二进制时报
exec: "gcc": executable file not found - Linux 二进制在 Alpine 容器里运行时报
not found（实际是 libc 不兼容） - macOS 上编译 Windows 二进制后，执行时报错退出，无日志
解决办法统一：CGO_ENABLED=0，例如：
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o myapp-arm64 ./cmd/myapp
禁用 cgo 后，net 会回落到纯 Go 实现（慢一点但可靠），os/user 会无法解析用户名（只返回 UID/GID），这是可接受的 trade-off。
自动化构建多平台二进制的脚本要点
手动敲命令容易漏平台、拼错后缀、忘记 CGO_ENABLED=0。推荐用 Shell 脚本批量处理，关键点有：
- 输出名要按平台区分，
GOOS=windows时必须加.exe后缀 - 每个
go build命令前都得带上CGO_ENABLED=0，不能只设一次环境变量再复用 - 建议加
-ldflags="-s -w"减小体积并去除调试信息 - 如果项目含
//go:embed或需要保留符号表，慎用-s
示例片段：
#!/bin/bash
platforms=("linux/amd64" "linux/arm64" "windows/amd64" "darwin/amd64")
for platform in "${platforms[@]}"; do
os=${platform%/*}
arch=${platform#*/}
output="myapp-$os-$arch"
if [ "$os" = "windows" ]; then output+=".exe"; fi
CGO_ENABLED=0 GOOS=$os GOARCH=$arch go build -ldflags="-s -w" -o "$output" ./cmd/myapp
done
GitHub Release 发布时容易忽略的细节
生成完二进制只是第一步，真正发布到 GitHub Release 还要注意：
- 每个文件必须校验 SHA256，避免传输损坏；CI 中建议用
sha256sum *.exe *.linux *.macos > checksums.txt - Release tag 必须是语义化版本（如
v1.2.3），且对应 Git commit 已打 tag - 文件名带平台标识（如
myapp_1.2.3_linux_amd64.tar.gz），方便用户一眼识别 - 不要把
dist/目录直接压缩上传 —— macOS 会悄悄塞进__MACOSX/元数据，Linux 用户解压后看到一堆隐藏目录
最麻烦的不是编译本身，而是确保所有平台产物都通过了最小运行验证：比如 Windows 二进制是否真能在 Win10/Win11 上双击启动，ARM64 二进制是否在 Raspberry Pi 上能连上网络 —— 这些没法靠 CI 自动覆盖，得留个手动 checklist。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
