Go 1.5+ 交叉编译时默认生成同名二进制文件，易导致多平台构建相互覆盖；通过 -o 参数可精确指定输出路径与文件名，实现跨平台产物隔离与可追溯性。
go 1.5+ 交叉编译时默认生成同名二进制文件，易导致多平台构建相互覆盖；通过 `-o` 参数可精确指定输出路径与文件名，实现跨平台产物隔离与可追溯性。
在 Go 1.5 及更高版本中，交叉编译已原生支持（无需额外工具链），但 go build 默认将输出文件命名为 ./<main-package-name>（如 main.go 所在包为 myapp，则输出 myapp），且不自动嵌入目标平台信息。当连续执行多个 GOOS/GOARCH 组合的构建时（例如先 GOOS=linux GOARCH=amd64，再 GOOS=windows GOARCH=386），后一次构建会直接覆盖前一次生成的可执行文件，不仅造成产物丢失，更难以分辨当前二进制对应的目标系统——尤其在 Linux/macOS 下无扩展名，无法直观识别。
解决此问题的核心方法是显式使用 -o 标志指定唯一输出路径。推荐按 <name>_<os>_<arch> 命名约定组织文件，提升可读性与自动化兼容性。例如：
# 构建 Linux 32位静态二进制 GOOS=linux GOARCH=386 CGO_ENABLED=0 go build -o dist/myapp_linux_386 . # 构建 Windows 64位（带 .exe 后缀，符合惯例） GOOS=windows GOARCH=amd64 CGO_ENABLED=0 go build -o dist/myapp_windows_amd64.exe . # 构建 macOS ARM64（Apple Silicon） GOOS=darwin GOARCH=arm64 go build -o dist/myapp_darwin_arm64 .
⚠️ 注意事项：
- CGO_ENABLED=0 对于纯 Go 项目建议启用，可确保完全静态链接、避免运行时依赖 C 库，提升跨平台可移植性；若项目含 cgo 代码，则需保留 CGO_ENABLED=1 并配置对应平台的 C 工具链。
- 输出路径（如 dist/）需提前创建，go build -o 不会自动创建父目录。
- 文件名中避免空格与特殊字符，以兼容 CI/CD 系统及 shell 脚本处理。
✅ 最佳实践：将交叉编译逻辑封装为 Makefile 或 shell 脚本，统一管理目标平台列表与输出规则。例如：
BINARY_NAME := myapp
DIST_DIR := dist
build-all:
@mkdir -p $(DIST_DIR)
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o $(DIST_DIR)/$(BINARY_NAME)_linux_amd64 .
GOOS=linux GOARCH=arm64 CGO_ENABLED=0 go build -o $(DIST_DIR)/$(BINARY_NAME)_linux_arm64 .
GOOS=windows GOARCH=amd64 CGO_ENABLED=0 go build -o $(DIST_DIR)/$(BINARY_NAME)_windows_amd64.exe .执行 make build-all 即可一键生成多平台产物，命名清晰、路径可控、零覆盖风险。
