跨平台编译必须显式设置goos和goarch且同步设cgo_enabled=0，否则大概率失败或生成不可移植二进制；二者缺一不可，go不自动补全，关闭cgo才能生成纯静态可执行文件。
直接说结论：跨平台编译不是“装完Go就能用”的功能，必须显式设置 GOOS 和 GOARCH，且绝大多数情况下要同步设 CGO_ENABLED=0，否则大概率构建失败或生成不可移植的二进制。
GOOS 和 GOARCH 必须成对出现，单独设一个没用
Go 不会自动推导缺失的变量。比如只运行 GOOS=linux go build，GOARCH 仍取你当前机器的值（Mac 上是 arm64 或 amd64），结果可能不是你要的 linux/amd64，而是意外的 linux/arm64 —— 这在服务器部署时容易翻车。
安全做法是始终写全：
GOOS=linux GOARCH=amd64 go build -o app-linuxGOOS=windows GOARCH=amd64 go build -o app.exeGOOS=darwin GOARCH=arm64 go build -o app-macos
不确定支持哪些组合？运行 go tool dist list，输出全是 os/arch 形式，比如 linux/386、windows/arm64。Go 1.21+ 起才原生支持 windows/arm64，旧版本会报错。
CGO_ENABLED=0 不是可选项，而是默认兼容性底线
只要你的代码没显式调用 C（比如没 import "C"、没用 // #cgo 注释、没依赖 mattn/go-sqlite3 这类包），就该强制关掉 CGO。原因很实际：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 开启 CGO 后，Go 会尝试链接目标平台的 C 标准库（如
libc或msvcrt），但宿主机上根本没这些头文件和链接器 - 即使硬配了交叉工具链（如
aarch64-linux-gnu-gcc），也极易因版本不匹配、路径错误导致build constraints exclude all Go files或链接失败 - 关闭后生成纯静态二进制，扔到目标机器上就能跑，不依赖系统级动态库
所以标准命令是：CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o app。漏掉 CGO_ENABLED=0，在 macOS 上编译 Linux 版本时经常卡在找不到 sys/socket.h。
Windows 编译要注意 .exe 后缀和 shell 语法差异
Linux/macOS 用户常忽略这点：Go 在 GOOS=windows 时不会自动加 .exe 后缀，得自己写。生成的文件名要是 app，Windows 上双击打不开；必须是 app.exe 才能被识别为可执行程序。
另一个坑是 Windows 命令行环境：
- cmd 中用
set GOOS=windows && set GOARCH=amd64 && go build -o app.exe - PowerShell 中不能用
=直接赋值，得写$env:GOOS="windows"; $env:GOARCH="amd64"; go build -o app.exe - 最稳妥的跨平台写法是用
env GOOS=windows GOARCH=amd64 go build -o app.exe（Linux/macOS）或cmd /c "set GOOS=windows && set GOARCH=amd64 && go build -o app.exe"（Windows）
资源文件和路径不是编译器管的事
很多人以为交叉编译完，把二进制拷过去就能跑，结果报错 open config.yaml: no such file or directory。这是因为：
- Go 编译器只打包 Go 源码，不会自动包含
config.yaml、templates/、libsqlite3.so这类外部文件 -
os.Executable()返回的是二进制自身路径，不是项目根目录；如果代码里写os.Open("config.yaml")，它会在当前工作目录找，不是二进制同目录 - 不同 OS 的路径分隔符（
/vs\）虽由path/filepath自动处理，但相对路径逻辑必须你自己写对
正确做法是：把配置文件和资源一起打包分发，并在代码里用 filepath.Dir(os.Args[0]) 定位二进制所在目录，再拼接资源路径。这个逻辑在所有平台都得验证，不能只测开发机。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
