go本身支持跨平台编译，无需为每个目标平台安装完整go环境；必须显式设置goos和goarch且二者缺一不可，cgo_enabled=0是实现稳定静态编译的关键，含c依赖时需目标平台构建或docker模拟。

Go 本身就能跨平台编译，不需要为每个目标系统装一套 Go；但必须显式设置 GOOS 和 GOARCH，且 CGO_ENABLED=0 是多数场景下稳定输出的关键开关。

GOOS 和 GOARCH 必须同时设，缺一不可

go build 默认只生成当前运行系统的二进制（比如在 macOS 上跑 go build，得到的是 darwin/amd64）。要生成其他平台程序，GOOS 和 GOARCH 必须成对出现：

• GOOS=linux GOARCH=amd64 go build -o app-linux main.go
• GOOS=windows GOARCH=arm64 go build -o app.exe main.go
• GOOS=darwin GOARCH=arm64 go build -o app-m1 main.go

常见组合可查：go tool dist list。注意：GOARM 仅在 GOARCH=arm 时需要（如 GOARM=7），arm64 架构不用设。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

CGO_ENABLED=0 才能真正“一次编译到处跑”

默认 CGO_ENABLED=1，Go 会链接 C 标准库，导致交叉编译失败（宿主机没有目标平台的头文件和链接器）。关闭后：

• 纯 Go 代码可静态链接，生成的二进制不依赖 libc 或目标系统 C 工具链
• 命令写法：CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o app main.go
• 如果项目用了 github.com/mattn/go-sqlite3 这类含 C 的包，关掉 CGO_ENABLED 会直接报错 import "C" not found
• 此时只能：① 在目标平台本机构建；② 用 Docker 模拟目标环境（如 docker run --rm -v $(pwd):/app -w /app golang:1.22-alpine go build -o app main.go）

资源路径和配置文件不会自动打包

Go 编译器只处理源码，不打包任何外部文件。即使你写了 os.ReadFile("config.yaml")，生成的二进制也不会自带这个文件：

• 运行时读取失败是常见问题，错误信息通常是 open config.yaml: no such file or directory
• 推荐做法：用 os.Executable() 定位二进制所在目录，再拼接相对路径
• 或把配置嵌入代码（用 //go:embed + embed.FS，Go 1.16+ 支持）
• Windows 下生成的 .exe 若双击无响应，检查是否用了 func main()（不是 func WinMain），Go 默认生成控制台程序，无需额外签名

最常被跳过的三件事：go env 换平台后没重看、go.mod 没提交、构建前没 go clean -cache -modcache。这三步不走，跨平台构建大概率在别人机器上跑不起来。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！