go跨平台编译必须显式设置goos和goarch，否则默认仅生成当前系统二进制；cgo_enabled=0可确保静态编译兼容性，含c依赖时需用docker或目标环境构建。
直接用 go build 编译出来的二进制文件，跑不到其他平台——这不是 bug，是 Go 的设计前提：跨平台编译必须显式指定目标环境，否则默认只构建当前系统可执行文件。
GOOS/GOARCH 必须显式设置才能跨平台
Go 原生支持交叉编译，但不会自动猜你要发到哪。漏掉 GOOS 或 GOARCH，就等于没跨平台。
-
GOOS=linux GOARCH=amd64 go build -o app-linux main.go→ Linux x86_64 -
GOOS=darwin GOARCH=arm64 go build -o app-mac main.go→ macOS Apple Silicon -
GOOS=windows GOARCH=386 go build -o app-win32.exe main.go→ 32 位 Windows
注意：GOOS 值不区分大小写，但 GOARCH 必须拼写准确（比如 arm64 不是 aarch64）；macOS 上构建 Windows 二进制时，.exe 后缀要手动加，Go 不会自动补。
Fyne 项目不能靠 go run 验证跨平台行为
go run main.go 只在当前系统启动 GUI，且跳过资源绑定、图标嵌入、清单生成等关键步骤，根本不能代表最终打包效果。
- 正确流程是先
fyne package -os windows -icon app.ico（或-os darwin/-os linux） -
fyne package会自动调用go build，再注入图标、签名配置、Info.plist 或 manifest - Linux 下若报
GLXBadContext，不是代码问题，而是 OpenGL 上下文初始化失败；临时加LIBGL_ALWAYS_SOFTWARE=1可绕过，但别上线用
图标必须是 .ico 格式，含 16×16、32×32、48×48、256×256 多尺寸，且放在项目根目录，路径写 -icon app.ico，不能写 ./resources/app.ico。
cgo 开关决定能否真正跨平台构建
一旦代码里用了 #include <stdio.h></stdio.h> 或调了 SQLite、OpenSSL 等 C 库，GOOS/GOARCH 就不够用了——Go 会尝试调用本地 C 编译器，而 macOS 的 clang 编不出 Windows 的 PE 文件。
- 禁用 cgo 是最干净的解法：
CGO_ENABLED=0 GOOS=windows go build -o app.exe main.go - 但代价是失去部分系统集成能力（如访问原生 Keychain、Windows CryptoAPI）
- 若必须用 cgo，就得用 Docker：在
golang:1.22-bookworm容器里跑GOOS=windows CGO_ENABLED=1 CC=x86_64-w64-mingw32-gcc go build
很多开发者卡在“本地能跑，CI 上失败”，根源就是 CI 环境没装 MinGW 或 Xcode Command Line Tools，而 CGO_ENABLED=1 时 Go 会静默 fallback 到系统默认 C 编译器，路径不对就直接报错。
模块模式（Go Modules）是跨平台一致性的底层保障
不用 go mod init 初始化，依赖就会走 GOPATH 模式，不同机器上拉的可能是不同 commit 的第三方库，导致“在我机器上能跑”这种问题反复出现。
- 新建项目第一件事：
go mod init example.com/myapp，立刻生成go.mod和go.sum - 确保
go env GO111MODULE输出on，而不是auto或空 -
go.sum必须提交进 Git，它是校验依赖完整性和一致性的唯一依据
很多人忽略 go.sum，结果换台机器 go build 就失败——因为 checksum 不匹配，Go 拒绝加载被篡改或不一致的模块。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
