gox多平台构建失败主因是CGO_ENABLED未启用、目标平台C工具链缺失或构建约束错误；需设CGO_ENABLED=1并显式指定CC_x86_64_linux_gnu等交叉编译器，避免fallback到主机gcc。
多平台构建失败，八成是 CGO_ENABLED 开关、工具链缺失或构建约束写错导致的，不是代码问题，而是环境和配置没对齐。
gox 交叉编译报 “unknown #:if” 或 “6c: No such file or directory”
这是 gox 默认以 CGO_ENABLED=0 运行，但项目依赖了 mattn/go-sqlite3 这类含 C 源码的包，Go 编译器直接拒解析 .c 文件所致。
- 必须显式启用 cgo：
CGO_ENABLED=1 gox -osarch="linux/amd64 darwin/arm64" - 仅开
CGO_ENABLED=1不够——还得确保目标平台有对应 C 编译器，比如 Linux 目标要x86_64-linux-gnu-gcc，macOS 要 Xcode Command Line Tools - 用
CC_x86_64_linux_gnu="x86_64-linux-gnu-gcc"显式指定交叉编译器，避免 fallback 到主机cc - macOS 构建
darwin/386已基本失效（10.15+ 不支持），别白费力气
go build 报 “exec: 'gcc': executable file not found”
这不是 Go 的错，是 cgo 启用后找不到 C 编译器。关键在 GoLand / 终端的 PATH 是否真包含 gcc 路径，且 Shell 配置被正确加载。
- 在 GoLand 内置终端执行
echo $PATH，和系统终端对比——常见问题是~/.zshrc里加了/usr/local/bin，但gcc实际在/usr/bin，而 PATH 被全量重写漏掉了 - GoLand 启动方式影响配置加载：桌面图标启动读
~/.zprofile或~/.profile，不读~/.zshrc；终端启动才读后者 - 验证是否生效：
which gcc输出路径，再看它是否在 GoLand 终端的PATH里 - Windows 上别用
set GOOS=linux，得用 PowerShell 语法：$ENV:GOOS="linux"
构建产物运行时报 “no such file or directory” 或崩溃
这往往不是构建失败，而是构建时用了错误的 GOOS/GOARCH，或静态链接没做全，导致运行时缺动态库或架构不匹配。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 确认构建命令是否带了
GOOS和GOARCH，且值合法：GOOS=linux GOARCH=arm64 go build；GOARCH=386在 macOS 上已不可用 - 含 cgo 的程序默认动态链接，Linux 上跑可能缺
libc；加CGO_ENABLED=0强制静态链接（但会丢掉 sqlite3 等功能） - macOS 构建的二进制在 Linux 容器里肯定跑不了，别指望“跨平台构建”等于“一次编译到处运行”
- 用
file ./myapp查看产物架构，用ldd ./myapp（Linux）或otool -L ./myapp（macOS）看依赖库
构建成功但某些文件没被打包进去
Go 不支持“排除文件”，只支持“不满足构建约束就不编译”。你以为删了或 .gitignore 了，其实它还在构建图里。
- 检查文件顶部是否有
//go:build !windows这类注释，且后面紧跟一个空行；写成//go:build ignore后，必须配合go build -tags ignore -
.gitignore对go build完全无效；go build -o /dev/null也不会跳过任何文件，只是把输出丢掉 - 测试文件（
_test.go）参与构建图，可能隐式引入循环依赖或意外拉入本不该编译的代码 - 用
go list -f '{{.ImportPath}} {{.GoFiles}}' ./...确认哪些文件实际被纳入了构建
最常被忽略的是：构建约束的空行要求、CGO_ENABLED 和 CC 工具链的配套关系、以及不同启动方式下 Shell 配置的加载差异——这些地方一错，错误信息根本不会指向真正原因。
