gox 默认禁用 cgo，导致依赖 c 代码的 sqlite3 包在交叉编译时失败；需显式启用 cgo 并配置对应平台的 c 工具链才能成功构建。
gox 是一个流行的 Go 交叉编译工具，但其默认行为（CGO_ENABLED=0）会直接跳过所有含 C 源码的包——这恰好是 github.com/mattn/go-sqlite3 的致命问题：该驱动内嵌了 sqlite3.c，必须通过 CGO 调用系统 C 编译器（如 gcc 或 clang）完成编译与链接。
从 Go 1.4 起，Go 工具链已严格限制 C 文件的编译逻辑：除非明确启用 CGO，否则 go build（及衍生工具如 gox）将直接拒绝处理 .c 文件，并报出类似 unknown #: if 或 No such file or directory: mingw.h 的错误——这些实为预处理器指令解析失败和缺失 Windows 兼容头文件的表象，根源仍是 CGO 被禁用后，Go 尝试用已弃用的内部汇编器（如 6c/8c）错误解析 C 代码。
✅ 正确解决方案是在调用 gox 时显式启用 CGO，并确保目标平台具备可用的 C 编译器：
# 启用 CGO，并指定支持的平台（注意：darwin/amd64 和 linux/amd64 通常最稳定）
CGO_ENABLED=1 gox -os="linux darwin" -arch="amd64" -output="./dist/{{.OS}}-{{.Arch}}/{{.Dir}}"
# 若需构建 linux/386 或其他架构，请先安装对应交叉编译工具链
# 例如 Ubuntu 上安装 32 位 gcc：
sudo apt-get install gcc-multilib
# macOS 用户可使用 Homebrew 安装 x86_64-elf-gcc（如需嵌入式目标）或确保 Xcode Command Line Tools 已就绪
xcode-select --install⚠️ 重要注意事项：
- CGO_ENABLED=1 不等于“可跨平台无缝构建”：CGO 启用后，gox 实际执行的是各目标平台原生的 go build，因此：
- 构建 linux/amd64 需在 Linux 环境或具备 gcc 的容器中运行；
- 构建 darwin/amd64 必须在 macOS 主机上执行；
- windows/amd64 需 Windows + MinGW-w64 或 MSVC 工具链。
- gox 本身不提供跨平台 C 工具链，它只是并发调度器。若需真正跨平台构建（如在 Linux 上产出 macOS 二进制），应改用 docker build + 多阶段镜像，或切换至 goreleaser（内置 CGO 与工具链管理）。
- 替代轻量方案：若仅需 SQLite 支持且可接受纯 Go 实现，可替换为 github.com/ziutek/mymysql（已归档） 或更现代的 modernc.org/sqlite，后者完全无 CGO 依赖。
总结：gox 报错本质是 Go 工具链对 C 代码的严格管控升级所致。修复核心在于理解 CGO 的平台绑定特性——启用它，同时尊重底层 C 编译环境的约束。对于持续集成场景，推荐将 gox 替换为 goreleaser，其通过标准化 Docker 镜像自动处理 CGO 与多平台编译，显著降低运维复杂度。
