Go原生支持交叉编译，通过GOOS和GOARCH环境变量指定目标平台，如GOOS=windows GOARCH=amd64构建Windows二进制；需配合GOARM、GOAMD64等子变量适配CPU特性，并在CI中用矩阵策略动态生成多平台构建任务。
用 GOOS 和 GOARCH 控制交叉编译目标
Go 原生支持跨平台构建，不需要额外工具链，关键就是设置环境变量 GOOS 和 GOARCH。比如构建 Windows 64 位二进制：在命令前加 GOOS=windows GOARCH=amd64 go build -o myapp.exe；Linux ARM64 则是 GOOS=linux GOARCH=arm64 go build -o myapp。
注意 GOARM（仅对 GOARCH=arm 有效）和 GOAMD64（影响 AVX 指令生成）这类子级变量也得按需设，否则可能在老 CPU 上 panic。
-
GOOS常见值：linux、windows、darwin、freebsd -
GOARCH常见值：amd64、arm64、386、arm（此时必须配GOARM=7） - macOS M1/M2 应用要显式用
GOARCH=arm64，GOARCH=amd64是 Rosetta 模拟，不是原生
CI 中避免硬编码平台列表，用矩阵策略动态生成
GitHub Actions 或 GitLab CI 都支持 job 矩阵（matrix），比写一堆重复 run 步骤更可靠。把目标平台定义成二维数组，让 CI 自动展开任务，失败时也能准确定位到哪个 GOOS/GOARCH 组合出问题。
例如 GitHub Actions 的 strategy.matrix 可这样写：
立即学习“go语言免费学习笔记（深入）”；
strategy:
matrix:
goos: [linux, windows, darwin]
goarch: [amd64, arm64]
exclude:
- goos: windows
goarch: arm64
- goos: darwin
goarch: amd64上面排除了 Windows + ARM64（暂不支持）、macOS + AMD64（非原生，且 Go 1.21+ 默认不鼓励）。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 务必检查 Go 官方文档的 支持平台矩阵，某些组合（如
GOOS=js）不产出可执行文件 - GitLab CI 用
include+variables实现类似效果，别用script里 if-else 判断平台 - 矩阵爆炸风险：3 个 OS × 3 个 ARCH = 9 个 job，若还要测不同 Go 版本，建议拆成两个独立 workflow
go build -ldflags 注入版本与构建信息
纯静态二进制没运行时环境，没法靠 git describe 动态查版本。必须在构建时用 -ldflags 把变量注入二进制的符号表里，后续用 myapp --version 才能输出真实信息。
典型做法是在 main.go 里声明变量：
var (
Version = "dev"
Commit = "unknown"
Date = "unknown"
)然后构建命令中传入：
go build -ldflags="-X 'main.Version=$VERSION' -X 'main.Commit=$COMMIT_SHA' -X 'main.Date=$(date -u +%Y-%m-%dT%H:%M:%SZ)'" -o myapp
-
-X要求包路径完整（如main.Version），不能只写Version - CI 环境变量名因平台而异：
GITHUB_SHA、CI_COMMIT_SHORT_SHA、BITBUCKET_COMMIT，建议统一用脚本提取 - Windows 下
date命令不兼容，改用powershell Get-Date -UFormat "%Y-%m-%dT%H:%M:%SZ"或预装coreutils
构建产物归档与命名需带平台标识
多平台构建后，如果所有二进制都叫 myapp，下载时根本分不清哪个是给树莓派用的。必须重命名或打包，格式要一致、可解析。
推荐命名规则：{name}_{goos}_{goarch}[{suffix}]，例如 myapp_linux_amd64、myapp_windows_arm64.exe。Windows 加 .exe 后缀是惯例，其他平台不加扩展名。
- 不要依赖
file命令识别格式——有些精简镜像没装它；靠文件名最直接 - 上传到 release 时，用 CI 的 artifact 机制（如
actions/upload-artifact）按 job 分开存，别合并成一个 zip - 若用
upx压缩，注意它不支持所有平台（如darwin/arm64目前无官方支持），压缩步骤应放在矩阵 job 内部，而非全局
交叉编译看着简单，但 CGO_ENABLED=0 开关、cgo 依赖的头文件路径、以及 macOS 的代码签名准备，这些才是真正卡住上线的点——它们不在构建命令里，而在你本地开发机和 CI runner 的环境差异中。
