Go跨平台构建需正确设置GOOS/GOARCH组合并禁用CGO，否则二进制不可移植；验证组合用go tool dist list，静态链接须设CGO_ENABLED=0，发布时加-ldflags="-s -w"减小体积。
Go 原生支持跨平台构建，不需要额外 SDK 或虚拟机，只要正确设置 GOOS 和 GOARCH，就能在一台机器上生成 Windows、Linux、macOS 等平台的可执行文件。关键不是“能不能”，而是“怎么设才不踩坑”。
GOOS/GOARCH 组合必须匹配目标平台
常见组合有 linux/amd64、windows/amd64、darwin/arm64、linux/arm64 等。用错组合会导致生成的二进制无法运行，比如在 macOS 上设 GOOS=windows 却漏写 .exe 后缀，或在 Linux 上设 GOOS=darwin 却没加 GOARCH=arm64，file 命令会直接报 “cannot execute binary file”。
验证支持列表最稳妥的方式是运行：
go tool dist list
输出中每一行都是合法组合，例如 linux/386、freebsd/amd64，不要凭记忆硬写。
立即学习“go语言免费学习笔记（深入）”；
-
GOOS错写成goos（大小写敏感）会导致变量被忽略，实际仍按当前系统构建 -
GOARCH=arm必须配合GOARM=7（旧 ARMv7），而arm64不需要额外变量 - macOS 上构建
darwin/amd64二进制，不能在 Apple Silicon（M1/M2/M3）上原生运行，除非开启 Rosetta；要真原生，必须用GOARCH=arm64
CGO_ENABLED=0 是跨平台静态链接的前提
默认开启 cgo 时，Go 会动态链接 libc 等系统库，导致生成的二进制只能在同类型系统上运行（比如 Linux 上编译的带 cgo 的程序，在 Alpine 容器里大概率报 no such file or directory）。跨平台构建尤其是面向容器或嵌入式设备时，必须禁用：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o app .
禁用后，所有依赖都静态链接进二进制，体积略增但可移植性拉满。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 若项目用了
net包（如 DNS 解析），CGO_ENABLED=0会让 Go 使用纯 Go 实现的 DNS 解析器，行为略有差异（比如不读取/etc/resolv.conf的某些选项） - Windows 下默认
CGO_ENABLED=1，但多数纯 Go 项目无需改，除非调用了 WinAPI - macOS 上禁用 cgo 后，
os/user.Lookup等函数可能返回空用户名，因依赖系统 C 库
Windows 构建其他平台时要注意命令语法和后缀
PowerShell 和 CMD 设置环境变量方式不同，且 Windows 的 go build 默认加 .exe 后缀——哪怕你设了 GOOS=linux，它依然可能生成 app.exe，这在 Linux 上根本没法执行。
推荐统一用 PowerShell（更现代），并显式指定输出名：
$env:GOOS="linux"; $env:GOARCH="amd64"; go build -o app-linux-amd64 .
CMD 用户请用：
set GOOS=linux && set GOARCH=amd64 && go build -o app-linux-amd64 .
- 别依赖
go build -o app自动加后缀，跨平台时永远显式命名 - PowerShell 中变量赋值后需在同一行或分号连接命令，否则变量只在当前语句生效
- 构建完立刻用
file app-linux-amd64（WSL 或 Git Bash）或sigcheck -a app-windows-amd64.exe（Windows）确认格式
构建脚本里加 -ldflags="-s -w" 减小体积并去调试信息
发布用的二进制不需要符号表和调试信息。-s 去除符号表，-w 去除 DWARF 调试数据，两者合用通常能减小 30%–50% 体积，对 CLI 工具或容器镜像尤其重要。
示例（Linux/macOS）：
GOOS=linux GOARCH=amd64 go build -ldflags="-s -w" -o bin/app-linux-amd64 .
注意：-ldflags 必须紧挨着 go build，不能写成 go build -o ... -ldflags=...（顺序错会导致参数被忽略）。
- 加了
-s -w后，dlv调试器将无法附加，仅适用于生产发布版 - 若项目用了
runtime/debug.ReadBuildInfo()，-ldflags="-s"会清空BuildInfo中的Settings字段，影响版本诊断逻辑 - CI 流程中建议分两套命令：开发用默认构建，发布流水线加
-ldflags="-s -w"
真正容易被忽略的是 CGO_ENABLED 和 GOOS/GOARCH 的耦合关系——不是设了目标平台就万事大吉，cgo 开关不对，照样生成不可移植的二进制。每次构建前花 3 秒确认这两个变量，比上线后排查“为什么在客户服务器上跑不了”省太多事。
