GOOS和GOARCH必须同时显式设置才能成功交叉编译，缺一不可；仅设其一将生成当前平台二进制，导致目标机器报cannot execute binary file；CGO_ENABLED=0是纯Go项目静态链接的必要开关，否则因动态链接libc等依赖而运行失败。
GOOS 和 GOARCH 必须同时显式设置才能交叉编译
Go 默认只构建当前系统平台的二进制，go build 不会自动适配目标环境。想在 macOS 上生成 Linux 二进制，光改 GOARCH 没用，必须配对设置 GOOS=linux 和 GOARCH=amd64（或 arm64）。
常见组合示例：
GOOS=windows GOARCH=amd64 go build -o app.exe main.goGOOS=darwin GOARCH=arm64 go build -o app-darwin-arm64 main.goGOOS=linux GOARCH=386 go build -o app-linux-386 main.go
运行 go tool dist list 可查当前 Go 版本支持的所有合法组合；Go 1.21+ 起才原生支持 GOOS=windows GOARCH=arm64，旧版本会报 unsupported GOOS/GOARCH pair。
CGO_ENABLED=0 是静态链接的关键开关
默认开启 CGO（CGO_ENABLED=1），会让 Go 链接宿主机的 C 标准库，导致交叉编译失败——因为你没有 Windows 的 windows.h 或 Linux 的 libc 头文件。
立即学习“go语言免费学习笔记（深入）”；
纯 Go 项目（无 // #cgo、未 import "C"、不依赖含 C 的第三方包）可安全关闭：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o app main.go- 生成的二进制完全静态，不依赖目标系统 libc，直接扔过去就能跑
但若用了 github.com/mattn/go-sqlite3 这类含 C 的包，关 CGO 会直接报错 cannot find package "C"；此时只能：在目标机器上构建，或用 Docker 模拟目标环境（如 docker run --rm -v $(pwd):/work -w /work golang:1.23-alpine go build -o app main.go）。
动态链接场景下必须匹配目标平台 C 工具链
启用 CGO 后，Go 会调用系统 C 编译器（如 gcc 或 clang）链接动态库。跨平台时，宿主机的 gcc 编不出 Windows 的 PE 文件。
可行方案只有两个：
- 在目标平台机器上本地构建（最稳妥）
- 用交叉 C 工具链：例如 Linux 上编译 Windows 程序，需提前装
x86_64-w64-mingw32-gcc，再设CC_x86_64_w64_mingw32=gcc和CGO_ENABLED=1 GOOS=windows GOARCH=amd64
注意：即使成功，生成的二进制仍可能依赖目标平台的 DLL（如 msvcrt.dll），部署时得一并带上，不能只丢一个 EXE。
资源文件和路径逻辑不会随编译自动适配
交叉编译只处理 Go 源码，不会打包同目录的 config.yaml、templates/ 或 libsqlite3.so。这些必须手动分发，并在代码里用 os.Executable 定位二进制所在目录，再拼接相对路径：
exePath, _ := os.Executable() rootDir := filepath.Dir(exePath) configPath := filepath.Join(rootDir, "config.yaml")
Windows 下还要注意：关闭 CGO 时，func main() 签名必须是标准入口，否则生成的 EXE 双击无反应；若用 func WinMain，得开 CGO 并链接 Windows SDK。
