交叉编译Go需显式设置GOOS和GOARCH，禁用CGO以保证静态链接，推荐gox或goreleaser自动化多平台构建，并注意路径分隔符与//go:embed路径规范。
GOOS 和 GOARCH 环境变量必须显式设置才能交叉编译
Go 本身不自动识别目标平台，go build 默认只编译当前运行环境的二进制。要生成 Windows 或 macOS 的可执行文件，必须手动指定 GOOS 和 GOARCH。比如在 Linux 上构建 Windows 程序：
GOOS=windows GOARCH=amd64 go build -o app.exe main.go常见错误是漏设其中一个变量，或拼写错误（如把
GOOS 写成 GO_OS），导致仍生成本地平台二进制。
CGO_ENABLED=0 是跨平台静态编译的关键开关
启用 CGO（CGO_ENABLED=1）会让 Go 调用系统 C 库，这直接破坏跨平台性——Linux 上链接的 libc.so 在 Windows 上根本不存在。绝大多数纯 Go 项目应禁用：
CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -o app-darwin-arm64 main.go只有当你明确依赖 cgo 绑定（如 SQLite、OpenSSL）时才需开启，但此时必须配套交叉编译工具链（如
x86_64-w64-mingw32-gcc），复杂度陡增。
使用 gox 或 goreleaser 可避免重复敲命令
手动写多组 GOOS/GOARCH 组合容易出错且不可维护。推荐用 gox（轻量）或 goreleaser（发布级）自动化：
gox -osarch="linux/amd64 windows/amd64 darwin/arm64" -output="./dist/{{.OS}}-{{.Arch}}/{{.Dir}}" ./cmd/app-
goreleaser需配置.goreleaser.yml，它会自动处理符号表、校验和、GitHub Release 上传
gox 不支持 Go Module 的 vendor 模式，若项目用了 go mod vendor，得改用 goreleaser 或手动加 -mod=vendor 参数。
Windows 上编译 Linux 二进制可能因路径分隔符出问题
Go 标准库对 \ 和 / 处理基本一致，但某些第三方包（尤其涉及文件遍历、embed 或模板路径）会在 Windows 环境下硬编码 \，导致生成的二进制在 Linux 运行时报 “no such file or directory”。排查方法：
- 用
strace（Linux）或Process Monitor（Windows）看实际打开的路径 - 所有路径拼接统一用
path/filepath.Join()，而非字符串 +"\\" - 嵌入静态资源时，
//go:embed后的路径必须用/，即使在 Windows 上编写
立即学习“go语言免费学习笔记（深入）”；
