go build交叉编译必须同时显式设置GOOS和GOARCH，缺一不可；CGO_ENABLED=0是生成静态二进制的硬性前提，否则易因C库不兼容导致构建失败或运行时报错。
go build 交叉编译必须同时设 GOOS 和 GOARCH
不设环境变量时，go build 只生成当前系统平台的二进制。想发给其他平台用户，必须显式指定目标操作系统和架构，缺一不可。
GOOS=linux GOARCH=amd64 go build -o myapp-linux ./cmd/myapp-
GOOS=windows GOARCH=amd64 go build -o myapp.exe ./cmd/myapp（.exe后缀可省略，Go 会自动加上） GOOS=darwin GOARCH=arm64 go build -o myapp-macos ./cmd/myapp
常见组合中：GOARCH=386 是 32 位 x86，不是 amd64 的别名；GOOS=windows 下默认带控制台窗口，GUI 应用需加 -ldflags "-H windowsgui"。
CGO_ENABLED=0 是静态二进制的硬性前提
只要项目用了 net、os/user、crypto/x509 等包，开启 cgo 就容易在跨平台构建或运行时报错，比如：
- Windows 上编译 Linux 二进制时提示
exec: "gcc": executable file not found - Linux 二进制在 Alpine 容器里启动失败，报
not found（实为 libc 链接问题） - macOS 编译的 Windows 二进制双击无反应、无日志
统一解法是强制禁用 cgo：CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o myapp ./cmd/myapp。验证是否成功：运行 file myapp，输出含 statically linked 即合规；ldd myapp 应返回 not a dynamic executable。
立即学习“go语言免费学习笔记（深入）”；
版本信息和构建元数据要靠 -ldflags 注入
直接 go build 生成的二进制没有版本号、提交哈希或构建时间，线上排查困难。必须在代码里预留变量，再用 -X 覆盖：
- 在
main.go里声明：var Version string、var BuildTime string - 构建命令写成：
go build -ldflags="-X 'main.Version=v1.2.3' -X 'main.BuildTime=$(date -u +%Y-%m-%dT%H:%M:%SZ)'" -o myapp ./cmd/myapp
注意：-X 的格式是 importpath.name=value；值含空格或特殊字符必须用单引号包裹，否则 Shell 会截断；$(date ...) 是 Bash 语法，CI 中需确认 Shell 类型。
批量构建多平台包推荐用 goreleaser
手动写一堆 GOOS=xxx GOARCH=yyy 命令容易漏、难维护，尤其要生成校验和、归档包、签名、SBOM、上传 GitHub Release 时，goreleaser 是事实标准。
- 初始化：
goreleaser init生成.goreleaser.yaml - 关键配置项：
builds[].goos、builds[].goarch、archives[].format（如tar.gz）、signs[] - 执行：
goreleaser release --snapshot（本地试跑），确认无误后去掉--snapshot
它默认启用 CGO_ENABLED=0，且所有构建在干净环境中进行，避免本地环境污染。但要注意：goreleaser 不处理 Docker 多架构镜像——那得用 docker buildx 单独做。
真正麻烦的不是命令怎么写，而是不同平台对路径分隔符、配置目录、信号处理的差异。这些没法靠 go build 解决，得在代码里用 filepath.Join、os.UserConfigDir、runtime.GOOS 显式适配。
