Go语言原生支持跨平台编译,只需设置GOOS和GOARCH环境变量即可生成目标平台可执行文件;推荐Go 1.16+版本,禁用cgo(CGO_ENABLED=0)可提升兼容性与体积,常用组合包括windows/amd64、darwin/arm64等。

Go 语言原生支持跨平台编译,无需额外安装虚拟机或交叉编译工具链。只要在任一主流系统(Linux/macOS/Windows)上安装 Go,就能通过设置 GOOS 和 GOARCH 环境变量,直接生成目标平台的可执行文件。
确认 Go 版本与基础要求
确保已安装 Go 1.16 或更高版本(推荐使用最新稳定版)。旧版本对 macOS ARM64(如 M1/M2)、Windows ARM64 支持不完整。可通过以下命令检查:
go version
Go 的跨平台编译能力内置在标准工具链中,不需要 gcc、cgo(除非你的代码显式依赖 C 代码)。若项目不含 #include 或 // #cgo 指令,编译纯 Go 程序时可完全禁用 cgo,大幅提升兼容性与体积:
立即学习“go语言免费学习笔记(深入)”;
CGO_ENABLED=0 go build -o myapp main.go
常用 GOOS 和 GOARCH 组合
以下是主流目标平台对应的环境变量组合(大小写敏感):
-
Windows x64:
GOOS=windows GOARCH=amd64→ 输出myapp.exe -
macOS Intel:
GOOS=darwin GOARCH=amd64→ 输出myapp(无后缀) -
macOS Apple Silicon:
GOOS=darwin GOARCH=arm64 -
Linux x64:
GOOS=linux GOARCH=amd64 -
Linux ARM64(如树莓派 4/5):
GOOS=linux GOARCH=arm64 -
Windows ARM64(如 Surface Pro X):
GOOS=windows GOARCH=arm64
注意:darwin 是 Go 中对 macOS 的内部标识;生成的二进制默认无扩展名,Windows 下建议手动加 .exe 后缀便于识别。
一键生成多平台可执行文件
可在 shell 脚本或 Makefile 中批量构建。例如,在 Linux/macOS 上创建 build.sh:
#!/bin/bash
CGO_ENABLED=0 go build -o bin/myapp-windows.exe -ldflags="-s -w" -o myapp.exe --ldflags="-s -w" GOOS=windows GOARCH=amd64 main.go
CGO_ENABLED=0 go build -o bin/myapp-darwin-amd64 -ldflags="-s -w" GOOS=darwin GOARCH=amd64 main.go
CGO_ENABLED=0 go build -o bin/myapp-darwin-arm64 -ldflags="-s -w" GOOS=darwin GOARCH=arm64 main.go
CGO_ENABLED=0 go build -o bin/myapp-linux-amd64 -ldflags="-s -w" GOOS=linux GOARCH=amd64 main.go
其中 -ldflags="-s -w" 可剥离调试信息和符号表,显著减小二进制体积。
Windows 用户注意事项
在 Windows 的 PowerShell 或 CMD 中设置环境变量语法不同:
-
PowerShell:
$env:GOOS="linux"; $env:GOARCH="amd64"; go build -o myapp-linux main.go -
CMD:
set GOOS=linux && set GOARCH=amd64 && go build -o myapp-linux main.go
也可使用 go env -w GOOS=linux GOARCH=amd64 全局设置(需后续用 go env -u GOOS GOARCH 清除),但不推荐长期修改,以免影响日常开发。
不复杂但容易忽略:跨平台编译只保证二进制能运行,不校验运行时依赖(如文件路径分隔符、系统调用差异)。务必在目标平台做最小验证(比如执行 ./myapp --help)。










