交叉编译需显式设置GOOS和GOARCH，成对使用；Windows目标须加.exe后缀；CI中推荐CGO_ENABLED=0、matrix策略批量构建；-ldflags平台相关，需校验产物类型与权限。
交叉编译前必须显式设置 GOOS 和 GOARCH
Go 的交叉编译不是自动的，不设环境变量就默认编译当前系统平台。CI 流水线里漏掉任一变量，构建产物就会跑在错误系统上——比如在 Linux x86_64 机器上没设 GOOS=windows，结果产出的是 Linux 可执行文件，却打包进 Windows 部署包。
实操建议：
-
GOOS和GOARCH必须成对出现，常见组合：GOOS=linux GOARCH=arm64、GOOS=darwin GOARCH=amd64、GOOS=windows GOARCH=386 - Windows 目标必须加后缀
.exe（go build -o myapp.exe），否则生成的文件无扩展名，在 Windows 上双击打不开 - 若用
CGO_ENABLED=0，能避免依赖宿主机 C 工具链，推荐在 CI 中强制开启，尤其目标平台与构建机不同时
GitHub Actions 中用矩阵策略批量构建多平台二进制
手动写多个 job 容易遗漏、难维护。用 strategy.matrix 能一次性触发所有目标平台构建，共享同一份源码和构建逻辑。
关键点：
立即学习“go语言免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 矩阵字段需映射到
env：例如os: [linux, windows, macos]→ 在 step 中用${{ matrix.os }}动态设GOOS - macOS runner 不支持
GOARCH=arm64构建 iOS 或 Apple Silicon 二进制（Apple M1/M2 芯片目标需用 Xcode 工具链），CI 中仅限构建 macOS 本机程序 - Linux arm64 构建建议用
ubuntu-latest（已预装 aarch64 工具链），别用self-hostedrunner 除非确认其内核和 binfmt 支持 QEMU 模拟
go build -ldflags 影响符号与版本信息注入
交叉编译时，-ldflags 仍生效，但要注意部分标志在不同平台行为不一致。比如 -H windowsgui 仅对 Windows 有效，加在 Linux 构建里会静默忽略；而 -s -w（去符号表/调试信息）在所有平台都可用，能显著减小体积。
典型用法：
- 注入 Git 版本：
-ldflags="-X main.version=${{ github.sha }} -X main.date=$(date -u +%Y-%m-%dT%H:%M:%SZ)" - 隐藏主函数符号（防简单逆向）：
-ldflags="-ldflags=-s -w"（注意嵌套引号） - Windows GUI 程序不弹终端窗口：
-ldflags="-H windowsgui"，但仅当GOOS=windows时才起作用
产物归档与上传前务必校验 file 输出和运行权限
CI 构建完不能直接上传。Linux/macOS 产物缺少可执行位、Windows 产物没 .exe 后缀、或误把 macOS 二进制传到 Linux 服务器，都是高频事故。
建议在 upload 前加验证步骤：
- Linux/macOS：
file ./myapp应输出类似ELF 64-bit LSB executable, ARM aarch64，且ls -l ./myapp显示-rwxr-xr-x - Windows：
file ./myapp.exe应含PE32+ executable (console) x86-64，且文件大小 >100KB（太小可能是空文件或构建失败） - 用
strip ./myapp（Linux/macOS）进一步瘦身，但仅限静态链接二进制；CGO 启用时慎用，可能破坏动态符号
跨平台构建最麻烦的不是编译本身，而是每个环节都得做平台感知判断——从环境变量、输出名、权限位，到最终校验命令，少一步就可能让下游部署卡住几个小时。
