Go跨平台编译必须从第一行代码起就设置GOOS和GOARCH环境变量，二者缺一不可，共同决定目标二进制格式与指令集；CGO_ENABLED=0是静态编译前提，build tag用于隔离平台专属逻辑。
Go跨平台编译不是“学完再用”的知识点，而是从写第一行main.go起就必须面对的工程现实——你写的程序，用户不一定用 macOS；你本地测试通过的 CLI 工具，客户可能扔进 Windows Server 或 ARM64 的边缘设备里跑。不提前对齐GOOS和GOARCH，交付时大概率收到一句“打不开”或“Exec format error”。
go build 前必须设的两个环境变量：GOOS 和 GOARCH
它们不是可选项，是目标二进制文件的“出生证明”。GOOS决定系统调用接口（比如open()在 Linux 是 syscall，Windows 是 CreateFile），GOARCH决定指令集（x86_64 vs arm64）和内存模型（如是否支持 unaligned load）。
-
GOOS=windows生成 PE 格式，自动加.exe后缀；GOOS=linux输出 ELF，无后缀 -
GOARCH=arm64对应 Apple M 系列、AWS Graviton、树莓派 4/5；GOARCH=amd64是传统 x86_64 - 组合必须真实存在：不存在
GOOS=darwin GOARCH=386（macOS 已弃用 32 位），go tool dist list可查全部合法组合 - 不设时默认取当前宿主平台，即你在 macOS 上
go build，结果只能在 macOS amd64 运行
CGO_ENABLED=0 是跨平台静态编译的硬性前提
只要代码里有#include <stdio.h>或用了net包以外的系统级操作（比如调用libusb），默认就会启用 CGO。而 CGO 编译器本身不具备跨平台能力——它只会调用你本机的gcc或clang，链接的是宿主系统的动态库。
- 启用 CGO 时，
GOOS=windows GOARCH=amd64 go build会直接报错：exec: "gcc": executable file not found in $PATH - 强制关闭：
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o app main.go - 关闭后，
net包会自动切到纯 Go 实现（net/http仍可用，但net.InterfaceAddrs()在某些 ARM 设备上可能返回空） - 若必须用 CGO（如 SQLite、OpenSSL），就得配目标平台的交叉编译工具链（如
aarch64-linux-musl-gcc），并设CC_aarch64_linux_musl等环境变量
多平台批量构建不能靠手动敲命令
一个真实项目至少要覆盖 linux/amd64、darwin/arm64、windows/amd64 三端。手敲 3 条命令易漏、难维护，CI 中更不可接受。
立即学习“go语言免费学习笔记（深入）”；
- 用
Makefile定义目标：make build-linux-amd64、make build-darwin-arm64，内部展开为对应GOOS/GOARCH组合 - 输出名需带平台标识：
-o bin/myapp-linux-amd64，Windows 要补.exe：-o bin/myapp-windows-amd64.exe - 加
-ldflags '-s -w'剥离调试符号，减小体积；加-trimpath消除绝对路径痕迹，保证可重现构建 - 脚本中避免硬编码路径，用
$(shell pwd)或$(CURDIR)，否则在 CI 的不同工作目录下会失败
build tag 不是锦上添花，而是跨平台逻辑隔离的刚需
有些功能天生平台专属：Windows 的服务注册、Linux 的syscall.Flock、macOS 的通知中心 API。把这些混在同一个.go文件里，会导致其他平台编译失败（未定义的函数或类型）。
- 按约定命名文件：
service_windows.go、service_linux.go、service_darwin.go - 文件顶部加构建标签：
// +build windows（注意前面两行空格），Go 编译器会按GOOS自动筛选 - 公共接口定义放在无标签的
service.go里，各平台实现文件只管实现，上层代码完全无感 - 别用
//go:build新语法（Go 1.17+）混搭旧// +build，CI 中低版本 Go 会忽略新语法导致构建遗漏
真正卡住人的从来不是“怎么设GOOS”，而是CGO_ENABLED=0带来的标准库行为变化、build tag 文件被意外忽略、或者批量脚本里忘了给 Windows 加.exe后缀——这些细节不跑一遍真实交付流程，根本意识不到它们的存在。
