Go原生不支持一键多平台构建，但通过Makefile封装GOOS/GOARCH组合命令（如GOOS=linux GOARCH=amd64 go build -o bin/app-linux-amd64）可实现一键生成多平台二进制，需显式设CGO_ENABLED=0、Windows加.exe后缀、输出路径带平台标识并前置mkdir -p bin/。
go build 本身不支持“一键多平台”，但通过组合 GOOS 和 GOARCH 环境变量 + 自动化脚本，就能真正实现一键生成 Windows、macOS、Linux 多平台二进制——关键不是靠单个命令，而是靠可复用的构建逻辑。
用 Makefile 封装多平台构建目标
Makefile 是最轻量又最可控的一键方案，无需额外依赖，所有主流系统原生支持 make。它把重复的 GOOS=xxx GOARCH=yyy go build 命令抽象成清晰目标，比如 make build-all。
- 每个平台目标独立定义，避免环境变量残留干扰（例如 Windows 下用
set，Linux/macOS 用export，Makefile 统一用 shell 执行） - 自动添加
.exe后缀仅限GOOS=windows场景，其他平台保持无后缀 - 推荐在
build前插入go clean -cache -modcache，防止本地缓存污染跨平台输出 - 示例片段：
build-linux-amd64: GOOS=linux GOARCH=amd64 go build -o bin/app-linux-amd64 . build-windows-amd64: GOOS=windows GOARCH=amd64 go build -o bin/app.exe . build-all: build-linux-amd64 build-windows-amd64 build-darwin-arm64
用 bash 脚本批量执行交叉编译
如果你不想引入 Makefile，一个 10 行以内的 build.sh 同样高效，且更易调试和 CI 集成。
- 必须用
#!/usr/bin/env bash开头，避免 macOS 默认zsh或旧版sh兼容问题 -
GOOS/GOARCH组合建议硬编码，不要动态解析，避免拼写错误导致静默构建失败（如把darwin写成macos） - 每条构建命令后加
&&连接，任一失败立即中断，而不是继续生成残缺二进制 - 示例：
#!/usr/bin/env bash GOOS=linux GOARCH=amd64 go build -o bin/app-linux-amd64 . && \ GOOS=windows GOARCH=amd64 go build -o bin/app.exe . && \ GOOS=darwin GOARCH=arm64 go build -o bin/app-darwin-arm64 .
cgo 启用时多平台构建会突然失败
只要代码里有 #import "C" 或间接依赖了 net、os/user、os/signal 等包，cgo 就默认启用——此时 GOOS=windows 在 Linux/macOS 上构建会报错：找不到 windows.h 或链接器失败。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 临时禁用：
CGO_ENABLED=0 GOOS=windows go build，但会丢失 DNS 解析、用户信息等系统能力 - 正确做法是：只在对应平台构建（如 Windows 上跑
GOOS=windows），或用 Docker 构建隔离环境（例如golang:1.22-alpine镜像里构建 Linux 二进制） - 检查是否启用了 cgo：
go env CGO_ENABLED；强制关闭：go env -w CGO_ENABLED=0（注意该设置全局生效）
输出文件名和路径管理容易被忽略
不同平台对可执行文件命名习惯不同，但 Go 不自动处理——你得自己控制 -o 参数，否则可能覆盖、漏写、或在 Windows 上生成无后缀的“不可双击”文件。
立即学习“go语言免费学习笔记（深入）”；
- Windows 必须带
.exe，否则系统不识别为可执行程序（即使GOOS=windows） - 建议统一输出到
bin/目录，并在.gitignore中加入/bin/，避免误提交 - 如果项目含多个
main包（如 CLI 工具 + HTTP 服务），需为每个指定-o，不能只靠默认名 - 别依赖
go build ./...的模糊匹配——显式写go build -o bin/cli cmd/cli/main.go更安全
CGO_ENABLED 的隐式开关、.exe 后缀遗漏、以及缓存没清导致某次构建“看似成功”却运行崩溃。每次新增平台目标前，先手动跑一遍对应命令确认能通，再封装进脚本或 Makefile。 
