gox 默认禁用 cgo，导致依赖 `mattn/go-sqlite3`（含 c 源码）的 go 项目在交叉编译时因无法识别 `sqlite3.c` 中的预处理指令而报错；需显式启用 cgo 并配置对应平台工具链。
gox 是一个轻量级的 Go 交叉编译工具，但它默认以 CGO_ENABLED=0 运行 —— 这对纯 Go 项目很安全，却会直接阻断所有含 C 代码的依赖（如 github.com/mattn/go-sqlite3）。你遇到的错误：
../../mattn/go-sqlite3/sqlite3.c:92 unknown #: if ../../mattn/go-sqlite3/sqlite3.c:94 6c: No such file or directory: mingw.h
本质是 Go 编译器在 CGO_ENABLED=0 下拒绝解析任何 .c 文件（自 Go 1.4 起强化该限制），并误将 C 预处理指令（如 #if）当作非法语法，同时尝试调用已弃用的内部汇编器（6c/8c），最终失败。
✅ 正确解法：启用 CGO 并确保目标平台具备对应 C 工具链
1. 启用 CGO（必需步骤）
在运行 gox 前，显式设置环境变量：
CGO_ENABLED=1 gox -os="linux darwin" -arch="amd64 386"
⚠️ 注意：CGO_ENABLED=1 仅开启 CGO，不自动提供 C 编译器。若目标平台缺少对应 cc（如 x86_64-linux-gnu-gcc 或 clang），仍会链接失败。
2. 为 Linux 目标安装交叉编译工具链（推荐方案）
-
Ubuntu/Debian：
sudo apt update && sudo apt install gcc-multilib g++-multilib # 或更完整的交叉工具链（可选） sudo apt install gcc-x86-64-linux-gnu gcc-i686-linux-gnu
- 然后通过 CC 环境变量指定：
CGO_ENABLED=1 CC_x86_64_linux_gnu="x86_64-linux-gnu-gcc" \ CC_i386_linux_gnu="gcc -m32" \ gox -osarch="linux/amd64 linux/386"
3. macOS 目标注意事项
- 确保已安装 Xcode Command Line Tools：
xcode-select --install
- 若构建 darwin/386（已废弃，仅兼容旧系统），需额外启用 32 位支持（macOS 10.15+ 默认不支持，建议改用 darwin/amd64 或 darwin/arm64）。
4. 替代方案：使用纯 Go SQLite 驱动（免 CGO）
若无需 SQLite 原生性能优化，可切换至纯 Go 实现以彻底规避 CGO 问题：
# 替换导入 import _ "modernc.org/sqlite" # 并在 go.mod 中替换依赖 replace github.com/mattn/go-sqlite3 => modernc.org/sqlite v1.29.0
✅ 优势：CGO_ENABLED=0 下可直接用 gox 无痛构建所有平台二进制。
总结
| 场景 | 推荐做法 |
|---|---|
| 必须用 mattn/go-sqlite3 | CGO_ENABLED=1 + 安装对应平台 C 工具链 + 显式指定 CC_* |
| 追求构建简洁性 & 兼容性 | 切换至 modernc.org/sqlite（纯 Go） |
| CI/CD 环境（如 GitHub Actions） | 使用预装 GCC 的 Ubuntu runner，并在 job 中设置 env: CGO_ENABLED: '1' |
最终，你的部署脚本可简化为：
# Linux + Darwin 通用构建（假设已配好工具链）
CGO_ENABLED=1 gox -osarch="linux/amd64 linux/386 darwin/amd64 darwin/arm64" -output="./dist/{{.OS}}-{{.Arch}}/{{.Dir}}"
只要 CGO 开启且底层 C 编译器就绪，gox 就能顺利完成含 SQLite3 的跨平台构建。
