必须显式设置GOOS=windows和GOARCH=amd64，否则生成的非PE格式文件无法在Windows运行；CGO_ENABLED=0可避免DLL依赖但限制net、os/user等功能，纯工具类程序推荐启用。
Go 本身不依赖目标平台的运行时环境，只要 GOOS 和 GOARCH 设置正确，就能直接产出可执行文件——但多数人卡在 CGO_ENABLED=0 是否该关、资源路径怎么写、以及为什么 Windows 编译出的程序双击没反应。
GOOS/GOARCH 必须显式设置，且组合必须合法
Go 默认只构建当前系统架构（比如你在 darwin/arm64 的 Mac 上跑 go build，结果一定是 macOS ARM64 二进制），不会自动推导目标平台。想跨平台，GOOS 和 GOARCH 缺一不可。
-
GOOS常见值：linux、windows、darwin；注意不是macos或win -
GOARCH常见值：amd64、arm64、386；ARM32 需额外设GOARM=7 - 不确定支持哪些组合？运行
go tool dist list查看当前 Go 版本允许的所有配对 - Go 1.21+ 才正式支持
windows/arm64；旧版本设了会报unsupported GOOS/GOARCH pair
CGO_ENABLED=0 不是可选项，而是稳定性的分水岭
启用 CGO（即 CGO_ENABLED=1）会让 Go 调用 C 标准库和系统头文件，而宿主机几乎不可能装齐所有目标平台的 C 工具链（比如你 Mac 上没有 windows.h，Linux 上没有 mach-o/loader.h）。一旦依赖含 C 代码的包（如 github.com/mattn/go-sqlite3），不关 CGO 就编译失败。
- 纯 Go 项目（无
// #cgo、未导入"C"、没调用net.LookupHost等隐式依赖 libc 的函数）——放心设CGO_ENABLED=0 - 设了
CGO_ENABLED=0后，生成的是完全静态链接二进制，不依赖目标机的libc或.NET运行时 - 若必须用 C 依赖，别在本地交叉编译：要么上目标机构建，要么用 Docker 拉对应镜像，例如
docker run --rm -v $(pwd):/app -w /app golang:1.21-alpine go build -o app main.go
Windows 编译要加 .exe 后缀，且 main 函数签名不能错
Go 在 Windows 上生成可双击运行的 GUI 程序，要求入口函数是 func main()，不是 func WinMain()（后者需 Win32 API 支持，Go 不提供）。但即便签名正确，如果没加 .exe 后缀，Windows 资源管理器会把它当普通文件，双击无响应。
立即学习“go语言免费学习笔记（深入）”；
- 命令里必须显式指定输出名带
.exe：GOOS=windows GOARCH=amd64 go build -o myapp.exe main.go - 即使
CGO_ENABLED=0，也要检查是否用了syscall或unsafe直接调用 Windows API——这类代码可能在非 Windows 平台编译通过，但在 Windows 上运行时报错 - 文件路径操作建议统一用
path/filepath，它会自动适配/和\；但硬编码C:\config.yaml这种写法在 Linux/macOS 构建时不会报错，运行时直接 panic
二进制不包含资源文件，路径逻辑必须手动适配
Go 编译器只打包代码，不会把 config.yaml、templates/ 或 libsqlite3.so 一起塞进二进制。你得自己处理分发和加载逻辑。
- 别用相对路径如
"./config.yaml"—— 程序启动位置不确定，很可能找不到 - 推荐用
os.Executable()定位二进制所在目录：dir, _ := filepath.Abs(filepath.Dir(os.Args[0]))，再拼接资源路径 - 如果用 embed（Go 1.16+），可把静态文件编译进二进制：
//go:embed config.yaml，但注意 embed 不支持动态文件或大体积二进制 - Docker 构建时，常把资源和二进制一起 COPY 进镜像；裸机部署则需写个安装脚本，校验目录结构
真正容易被忽略的，是“编译成功”不等于“能跑通”：路径错、资源缺、CGO 依赖漏掉、甚至 Windows 上少了个 .exe 后缀，都会让程序静默失败。每次换平台，最好用 file 命令（Linux/macOS）或 dumpbin /headers（Windows）确认目标架构，再扔到对应系统里跑一行 ./xxx --help 看是否吐出预期输出。
