go跨平台编译必须显式设置goos和goarch，缺一不可；推荐组合cgo_enabled=0 goos=linux goarch=amd64 go build -o gin-app .，确保静态链接、兼容alpine等精简镜像。
Go build 的 -o 和 -ldflags 参数必须显式指定
跨操作系统打包时，go build 默认生成当前平台的可执行文件。想在 macOS 上编译出 Linux 可执行文件（比如部署到 Docker），必须显式设置 GOOS 和 GOARCH。漏掉任一参数都可能导致运行时报错，比如 exec format error（常见于 macOS 编译后扔进 Alpine 容器跑不起来）。
推荐写法：
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o gin-app .
-
CGO_ENABLED=0关键：禁用 cgo 后，二进制不依赖系统 libc，才能在 Alpine 这类精简镜像中直接运行 -
-o显式指定输出名，避免默认生成./gin-app路径问题 - 不要依赖
go run或未加约束的go build—— 它们永远只产出本地平台二进制
Windows 下编译 Linux 二进制会遇到路径分隔符陷阱
Windows 用户用 PowerShell 或 CMD 执行 GOOS=linux go build 会失败，因为 = 不是 Windows 命令行的变量赋值语法。直接复制 Linux/macOS 的命令会卡在 “command not found”。
正确做法：
- PowerShell 中用：
$env:GOOS="linux"; $env:GOARCH="amd64"; $env:CGO_ENABLED="0"; go build -o gin-app . - CMD 中用：
set GOOS=linux && set GOARCH=amd64 && set CGO_ENABLED=0 && go build -o gin-app . - 更稳妥的是用 WSL2：所有命令和路径行为与 Linux 一致，无兼容性干扰
Docker 多阶段构建里必须复用同一套 GOOS/GOARCH
很多 Dockerfile 在 builder 阶段用 golang:alpine，但 runtime 阶段用 alpine:latest，却忘了 builder 阶段没设 GOOS —— 导致构建出的二进制仍是 Linux/amd64，但若目标容器是 ARM64（如 Apple Silicon Mac 上的 Docker Desktop），就会启动失败。
检查点：
- builder 阶段的
FROM镜像架构要和目标一致（golang:1.24-alpinevsgolang:1.24-alpine@sha256:xxx） -
go build命令必须带完整环境变量，不能只靠镜像默认值 - 用
file gin-app在容器内验证：输出里要有ELF 64-bit LSB executable, x86-64或ARM aarch64字样
macOS M 系列芯片打包 Linux ARM64 服务需额外注意
M1/M2/M3 芯片是 ARM64 架构，但 macOS 本身不是 Linux。直接 GOOS=linux GOARCH=arm64 go build 是可行的，但容易忽略两点：
- 某些 C 依赖（比如 SQLite、OpenSSL）在禁用 cgo 后不可用，若业务强依赖，得改用
CGO_ENABLED=1并配交叉编译工具链，复杂度陡增 - Docker Desktop for Mac 默认启用 Rosetta 模拟 x86-64，若没关掉，
GOARCH=arm64编出来的镜像可能被误当成 x86 跑，报错standard_init_linux.go:228: exec user process caused: exec format error
最省事的路径：M 系列机器上统一用 GOARCH=amd64 打包，适配主流云服务器；真要 ARM64，优先走 CI（GitHub Actions 的 ubuntu-latest runner 原生支持 arm64）。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
