必须同时设置goos和goarch才能交叉编译，缺一不可；cgo_enabled=0是纯go项目跨平台编译的刚需，可生成静态二进制；输出文件名须含平台标识以防覆盖；构建约束（如//go:build linux）用于编译期条件化包含平台专属代码。
直接用 GOOS 和 GOARCH 环境变量控制，缺一不可；不设就默认编译当前系统平台，不是“自动跨平台”。
GOOS 和 GOARCH 必须同时设置才生效
Go 不会猜测你要交叉编译——必须显式声明目标操作系统和架构。只设 GOOS=linux 而不设 GOARCH，构建结果仍是当前机器的架构（比如 macOS 上仍是 darwin/amd64）。
GOOS=linux GOARCH=amd64 go build -o myapp-linux-amd64 main.goGOOS=darwin GOARCH=arm64 go build -o myapp-macos-arm64 main.go-
GOOS=windows GOARCH=386 go build -o myapp-win32.exe main.go（注意：Windows 下建议显式加.exe）
验证支持组合可用：go tool dist list | grep linux 或完整列出所有合法对。
CGO_ENABLED=0 是多数跨平台场景的刚需
启用 CGO（即 CGO_ENABLED=1）时，Go 会尝试调用目标平台的 C 工具链和头文件——而宿主机通常没有 Windows 的 windows.h 或 Linux 的 libc 头文件，导致编译失败。
- 纯 Go 项目（无
// #cgo、未 import"C"、不依赖 sqlite3/cgo 等包）→ 强烈建议加CGO_ENABLED=0 - 含 C 依赖的项目（如
github.com/mattn/go-sqlite3）→ 关闭 CGO 会报错，此时应改用 Docker 构建或在目标平台本地编译 -
CGO_ENABLED=0还能生成完全静态链接的二进制，避免部署时缺库
示例：CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o myapp-linux-arm64 main.go
输出文件名必须带平台标识，否则必然覆盖
默认 go build 输出为 ./myapp（无后缀），连续构建多个平台时，后一次会直接覆盖前一次——你根本分不清哪个是 linux/amd64，哪个是 darwin/arm64。
- 务必用
-o指定明确路径和文件名，例如-o bin/myapp-linux-amd64 - Windows 目标下，若
-o指定的名称不含.exe，Go 会自动追加；其他平台严格按所给名称输出（myapp-macos就是myapp-macos，不会加后缀） - 建议统一格式：
{name}-{GOOS}-{GOARCH}或{name}_{GOOS}_{GOARCH}，便于脚本识别和 CI 分发
错误示范：GOOS=linux go build main.go && GOOS=windows go build main.go → 最终只剩一个 main.exe 或 main，且来源不明。
构建约束（build tags）用于条件化编译平台专属代码
当你的项目需要为不同系统实现不同逻辑（比如 Linux 用 systemd、macOS 用 launchd、Windows 用 SCM），不能靠运行时判断再 import，而应在编译期剔除不相关代码。
- 把平台逻辑拆成独立文件，命名如
service_linux.go、service_darwin.go、service_windows.go - 每个文件顶部加构建约束注释：
// +build linux（注意空行）或更现代的//go:build linux - 这样
GOOS=linux go build时，只有service_linux.go参与编译，其余被完全忽略（不解析、不类型检查）
关键点：构建约束不是注释开关，它由 go build 在解析阶段硬过滤——写错格式（比如漏空行、混用 // +build 和 //go:build）会导致文件永远不被选中。
最容易被忽略的是：环境变量在 go build 启动瞬间就固化，代码里读到的 runtime.GOOS 永远是构建机的系统，不是目标平台。别指望用它做编译期分支——那得靠构建约束或 -tags 参数。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
