go build 本身不繁琐，繁琐的是没理清构建目标与运行环境的边界；交叉编译必须设 CGO_ENABLED=0，否则易因系统库依赖失败；-ldflags 需注入版本与时间，嵌入资源路径须严格匹配前端产物目录。
go build本身不繁琐，繁琐的是没理清「构建目标」和「运行环境」的边界——你不需要在每个平台装 Go，但必须明确告诉编译器你要生成哪个平台的二进制。
交叉编译前必须关掉 CGO
Linux/macOS 上默认启用 CGO_ENABLED=1，但跨平台编译 Windows 或静态链接时，它会拉入系统库导致失败或动态依赖。
所有交叉编译命令开头都得加：CGO_ENABLED=0。
- Windows 二进制（无控制台黑窗）：
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -ldflags="-H windowsgui" -o myapp.exe ./cmd/myapp - Linux ARM64（如树莓派）：
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o myapp-linux-arm64 ./cmd/myapp - macOS Intel：
CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -o myapp-macos-x64 ./cmd/myapp
漏掉 CGO_ENABLED=0 是最常见报错根源，比如 cannot load runtime/cgo 或生成的 Windows 二进制在无 Go 环境机器上闪退。
嵌入前端资源时路径必须严格匹配
//go:embed 不是“找文件”，而是“按字面路径打包”。前端构建输出到 dist/，你就得写 //go:embed dist/*；输出到 frontend/dist/，就得写 //go:embed frontend/dist/*——少一个目录名，运行时就是 fs: file does not exist。
- 确保前端先构建：
npm run build或pnpm build完成后再执行go build - Go 1.20+ 支持
dist/**/*匹配子目录，但 Go 1.19 及更早只认dist/*（不递归） - 隐藏文件（如
.gitkeep）默认不被dist/*匹配，若需占位，显式列出或改用通配符
减小体积和去除调试信息是上线必选项
默认 go build 产出的二进制含调试符号和 DWARF 信息，多出 2–3MB，且可能泄露路径、变量名等敏感信息。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 必须加
-ldflags="-s -w"：-s去符号表，-w去 DWARF 调试信息 - UPX 压缩可再减 30–50%，但某些安全策略禁止加壳，生产环境慎用
- 注意：加了
-s -w后，pprof和部分 panic 栈追踪会丢失文件行号
版本号和构建时间得靠 -ldflags 注入，不是写死在代码里
硬编码 var Version = "v1.2.3" 每次发版都要改源码，容易漏或冲突。正确做法是在构建时注入：
- 代码中声明：
var Version string、var BuildTime string（都在main包） - 构建命令：
go build -ldflags="-X 'main.Version=v1.2.3' -X 'main.BuildTime=$(date -u +%Y-%m-%dT%H:%M:%SZ)'" -o myapp ./cmd/myapp - 单引号必须保留，否则 Shell 会把空格和
$()截断；$(date)在 Windows PowerShell 不生效，CI 中建议用date -u或预设环境变量
真正容易被忽略的，是嵌入路径与前端构建产物目录的实时一致性——不是“写对一次就完事”，而是每次 git pull 后，都要确认 dist/ 是否存在、是否最新、路径是否被重构过。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
