Go不支持单二进制多架构，需一次源码多次构建不同GOOS/GOARCH组合的独立可执行文件；GOOS与GOARCH必须成对设置，不可混用；cgo会破坏纯Go跨平台能力，推荐CGO_ENABLED=0；构建后须验证目标平台兼容性。
Go 本身不支持“单个二进制同时适配多种芯片架构”，所谓“多平台应用”是指**一次源码，多次构建出不同 GOOS/GOARCH 组合的独立可执行文件**——不是打包成一个 fat binary，而是生成多个专用二进制。这是 Go 跨平台能力的核心机制，也是最稳妥、最广泛采用的方式。
GOOS 和 GOARCH 必须成对设置，不能混用
Go 编译器在构建时严格绑定目标操作系统和 CPU 架构。比如 GOOS=linux GOARCH=arm64 生成的是 Linux ARM64 的 ELF 文件；GOOS=darwin GOARCH=arm64 是 macOS ARM64 的 Mach-O 文件——两者无法互换，也不能合并。
- 常见组合必须记牢：
linux/amd64、linux/arm64、windows/amd64、darwin/amd64、darwin/arm64 -
GOARCH=386已基本淘汰，除非要兼容老旧 Windows XP；GOARCH=arm（32 位）仅用于特定嵌入式设备，需额外设GOARM=7 - 不要尝试
GOOS=linux GOARCH=arm64+GOOS=windows GOARCH=amd64同时生效——go build 不接受多组环境变量叠加
构建脚本要显式命名输出，避免 .exe 后缀污染 Unix 平台
Windows 下 go build 默认加 .exe 后缀，但 GOOS=linux 时这个行为不会自动取消。如果你在 Windows 上执行 GOOS=linux go build -o app，实际输出仍是 app.exe（Windows 文件系统允许），但该文件在 Linux 上根本不可执行。
- 务必显式指定不含后缀的输出名：例如
GOOS=linux GOARCH=amd64 go build -o bin/app-linux-amd64 main.go - PowerShell 中设置变量语法是
$env:GOOS="linux"; $env:GOARCH="amd64"，不是export；CMD 中用set GOOS=linux && set GOARCH=amd64 - 建议统一用 Bash 脚本（即使在 Windows 上用 Git Bash 或 WSL），避免 shell 语法差异导致构建失败
cgo 是跨平台构建的最大陷阱
只要代码里有 #include、调用了 C 函数（如 SQLite、OpenSSL、系统调用封装），或依赖启用了 cgo 的第三方包（如 net 包在某些配置下会 fallback 到 cgo），构建就不再“纯 Go”。此时 CGO_ENABLED=0 会直接报错，而 CGO_ENABLED=1 又要求本地装对应平台的 C 工具链。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 纯 Go 模式（
CGO_ENABLED=0）能生成完全静态链接的二进制，推荐优先使用 - 若必须用 cgo（比如要调用 Windows API 或 Linux seccomp），应在目标平台或 Docker 容器中构建：
docker run --rm -v $(pwd):/src -w /src golang:1.22-alpine go build -o app-linux-arm64 -ldflags="-s -w" ./cmd/myapp - 检查是否意外启用了 cgo：运行
go env CGO_ENABLED，并确认go list -f '{{.CgoFiles}}' ./...输出为空
验证构建结果比编译成功更重要
很多问题只在部署时暴露：比如在 macOS 上构建的 darwin/arm64 二进制，拿到 Apple Silicon Mac 上仍报 “damaged and can’t be opened”，其实是签名或公证问题；又比如 Linux 二进制在 Alpine 容器里启动失败，是因为它链接了 glibc，而 Alpine 用的是 musl。
- Linux/macOS 上用
file app-linux-arm64确认输出含ELF 64-bit LSB executable, ARM aarch64 - macOS 上用
codesign -dv --verbose=4 app-darwin-arm64查签名状态；若未签名，临时用xattr -rd com.apple.quarantine app-darwin-arm64解除隔离 - Alpine 场景下，要么用
golang:alpine镜像构建，要么加-ldflags '-linkmode external -extldflags "-static"'强制静态链接
真正容易被忽略的点是：平台特定代码（如 // +build linux）和构建标签不会在编译时自动报错，哪怕你用 GOOS=windows 构建，含 // +build linux 的文件也会被静默跳过——这会导致功能缺失却无提示。务必用 go list -f '{{.GoFiles}}' -tags linux ./... 类似方式，按目标平台 tag 主动检查参与编译的文件集。
