交叉编译必须显式设置GOOS和GOARCH，缺一不可；CGO_ENABLED=0是静态链接前提，否则因libc依赖导致目标平台运行失败；-ldflags可注入版本与时间，embed.FS用于打包前端资源。
交叉编译必须显式设置 GOOS 和 GOARCH
Go 默认只编译当前系统平台的二进制，想生成 Linux、Windows 或 macOS 的可执行文件，必须手动指定目标环境。不设 GOOS/GOARCH 就直接 go build，结果永远是本地产物，发给用户大概率打不开。
常见组合要记牢：
-
GOOS=linux GOARCH=amd64→ 通用 Linux x86_64 -
GOOS=windows GOARCH=amd64→ Windows 64 位（自动加.exe后缀） -
GOOS=darwin GOARCH=arm64→ Apple Silicon Mac（Go ≥ 1.16 才支持） -
GOOS=linux GOARCH=arm64→ 树莓派 4/5、AWS Graviton 等 ARM 服务器
注意：GOARCH=386 是 32 位 x86，不是 “x86_64” 的缩写；GOARM 已弃用，别用。
CGO_ENABLED=0 是跨平台静态链接的前提
默认开启 CGO 时，Go 会动态链接 libc 等系统库，导致在 Alpine、不同发行版 Linux 或 Windows 上运行失败，典型错误是 standard_init_linux.go:228: exec user process caused: no such file or directory。
立即学习“go语言免费学习笔记（深入）”；
安全做法是统一禁用：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 所有交叉编译命令前加
CGO_ENABLED=0 - 验证是否成功：用
file myapp查看输出含statically linked即可 - 若真依赖 C 库（如 SQLite、OpenSSL），就得为目标平台装对应 C 工具链，复杂度陡增，普通 CLI 工具不建议走这条路
嵌入版本号和构建时间要用 -ldflags -X
硬编码 var Version = "v1.2.3" 没用，每次改都要改代码。正确方式是在构建时注入：
go build -ldflags="-X 'main.Version=v1.2.3' -X 'main.BuildTime=$(date -u +%Y-%m-%dT%H:%M:%SZ)'" -o myapp ./cmd/myapp
关键点：
-
-X格式是importpath.name=value，main 包变量就写main.Version - 值里含空格或特殊字符（比如日期中的冒号），必须用单引号包裹，否则 Shell 会截断
- 变量需在代码中声明为
var Version string，不能是常量或未导出字段
前端资源打包进二进制得靠 embed.FS
如果你的 Go 服务要托管 Vue/React 构建后的 dist/ 目录，别指望 http.FileServer 自动读硬盘——二进制里根本没有那个路径。
必须用 Go 1.16+ 的 embed：
- 在
main.go顶部加//go:embed dist/*（路径必须和实际构建输出完全一致） - 声明
var distFS embed.FS - 构建前先跑
npm run build或pnpm build，再执行go build；顺序错就报fs: file does not exist - 通配符
dist/*不包含子目录下的隐藏文件（如.gitkeep），需要就显式列出或升级到 Go 1.20+ 用dist/**/*
真正容易被忽略的是：嵌入是编译期行为，和 GOOS/GOARCH 无关；但你忘了先构建前端，或者路径写错一级，运行时就直接 panic。
