必须交叉编译：GOOS=linux GOARCH=amd64（或arm64）go build -o myapp main.go；启用CGO_ENABLED=0确保静态链接，加-ldflags="-s -w"减小体积，否则Linux运行报Exec format error。
Go 跨平台编译不是“选配”，而是部署前必须确认的环节；不设 GOOS 和 GOARCH，go build 默认只生成当前系统能跑的二进制文件。
怎么用 go build 生成 Linux 服务器能跑的程序
本地开发机是 macOS 或 Windows，但目标服务器是 Linux？直接 go build 出来的文件在 Linux 上大概率报错：cannot execute binary file: Exec format error。这是因为默认编译出的是当前 OS+Arch 的可执行文件。
- 明确设置目标环境：
GOOS=linux GOARCH=amd64 go build -o myapp main.go - 若目标服务器是 ARM64（如 AWS Graviton、树莓派），改用：
GOOS=linux GOARCH=arm64 go build -o myapp main.go - Windows 用户注意：PowerShell 中需用
$env:GOOS="linux"等语法，推荐统一用 bash/sh 执行，或直接写成一行命令避免 shell 差异
CGO_ENABLED=0 什么时候必须加
一旦代码里用了 cgo（比如调用 net 包里的 DNS 解析、SQLite 驱动、或任何带 // #include 的注释），Go 默认启用动态链接，生成的二进制会依赖目标机器的 libc。而 Alpine Linux 等精简镜像不含完整 libc，直接运行就报 not found 或 no such file or directory。
- 强制静态链接：在交叉编译时加上
CGO_ENABLED=0，例如：CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp main.go - 副作用：禁用
cgo后，net包会回退到纯 Go 实现（DNS 查询走 TCP/UDP 而非系统 resolver），os/user等包可能无法解析用户名——如果业务强依赖这些，就得保留cgo并用glibc基础镜像（如debian:slim） - 验证是否静态链接成功：运行
file myapp，输出含statically linked即为成功；若含dynamically linked，说明CGO_ENABLED没生效或被其他地方覆盖
构建多平台二进制时容易漏掉的细节
一次发布要同时支持 macOS、Windows、Linux 多个平台？别手动敲三遍命令——但自动化脚本里常忽略两件事：一是 GOARM 对 ARM 架构的隐式影响，二是 -ldflags 对体积和调试信息的控制。
立即学习“go语言免费学习笔记（深入）”；
-
GOARCH=arm64在 macOS 和 Linux 下语义一致，但GOARCH=arm必须配合GOARM=7（常见于树莓派），否则编译失败或运行崩溃 - 减小二进制体积：
-ldflags="-s -w"可去掉符号表和调试信息，通常能压缩 20%~40%，加在 build 命令末尾：go build -ldflags="-s -w" -o myapp main.go - 版本注入建议用
-ldflags="-X main.version=1.2.3"，但要注意变量必须是var version string形式且在main包里，否则注入无效
跨平台编译最麻烦的不是命令记不住，而是错误发生在部署后——比如在 Alpine 容器里 panic 报 libc 缺失，或者 ARM64 服务启动后 DNS 解析超时。务必在 CI 流程里对每个目标平台做最小化运行测试，哪怕只是 ./myapp --help 能执行完。
