go build 默认不生成单文件，必须显式禁用 CGO_ENABLED=0；Iris 虽纯 Go 实现，但默认启用 cgo 会链接 libc，导致动态依赖；需结合 GOOS/GOARCH 交叉编译并验证 statically linked。
go build 默认不生成单文件，必须显式禁用 CGO
Go 编译出单可执行文件的核心前提是：关闭 CGO_ENABLED。Iris 本身纯 Go 实现，不依赖 C 库，但只要环境变量 CGO_ENABLED=1（默认值），go build 就会尝试链接系统 libc，导致生成的二进制仍需动态库支持，无法真正“单文件”运行。
正确做法是强制设为 0：
CGO_ENABLED=0 go build -o myapp main.go
Windows 用户注意：cmd 中用 set CGO_ENABLED=0，PowerShell 中用 $env:CGO_ENABLED="0"，否则编译仍可能带动态依赖。
第三方依赖引入了 cgo？检查并清理
即使你的代码没调 C，Iris 项目若间接依赖了含 #cgo 的包（比如某些日志、加密、数据库驱动），CGO_ENABLED=0 会直接报错，例如：
undefined: syscall.Getpagesize 或 import "C" not allowed in plugin mode
常见踩坑点：
- 用了
github.com/mattn/go-sqlite3—— 它强依赖 cgo，必须换为纯 Go 的替代方案（如modernc.org/sqlite） - 启用了 Iris 的
iris.WithOptimization并搭配某些压缩中间件（如 brotli），部分实现含 cgo - 开发时本地装了
gcc，Go 自动启用 cgo；CI/CD 环境未统一配置，导致构建结果不一致
交叉编译时务必指定 GOOS/GOARCH，且保持 CGO_ENABLED=0
想在 macOS 上编译 Linux 版本供服务器部署？不能只写 GOOS=linux go build，必须同时锁定 CGO：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp-linux main.go
否则即使指定了 GOOS，只要 CGO_ENABLED=1，Go 仍会尝试调用本地 gcc 交叉编译 libc 相关符号，失败或生成非静态二进制。
常用组合：
-
CGO_ENABLED=0 GOOS=windows GOARCH=amd64→ 生成.exe，无 DLL 依赖 -
CGO_ENABLED=0 GOOS=linux GOARCH=arm64→ 适配 ARM64 服务器（如 AWS Graviton） -
CGO_ENABLED=0 GOOS=darwin GOARCH=arm64→ Apple Silicon 原生二进制
验证是否真为静态单文件
编译完别急着扔到服务器，先本地确认：
- Linux/macOS 下执行
file myapp，输出含statically linked才算成功；若出现dynamically linked，说明 CGO 没关干净 - 用
ldd myapp（Linux）或otool -L myapp（macOS）检查动态库依赖，空输出才安全 - 把二进制拷到一台干净 Docker 容器里（如
alpine:latest）直接运行，能起来才算真正可移植
最容易被忽略的是：开发机上测试通过，但上线后因某个被忽略的间接依赖（比如日志中悄悄引入的 golang.org/x/sys/unix 在特定 GOOS 下触发 cgo）导致 panic —— 静态链接验证这步不能跳。
