Go跨平台编译需设置GOOS和GOARCH环境变量，支持原生交叉编译；可用go tool dist list查看有效组合；临时编译用命令行指定，全局设置需导出环境变量；注意CGO默认禁用、系统调用兼容性及路径权限差异。
在 Go 中实现跨平台编译，核心就是正确设置 GOOS（目标操作系统）和 GOARCH（目标 CPU 架构）环境变量。Go 原生支持交叉编译，无需额外安装工具链，只要配置好这两个变量，就能直接构建出对应平台的二进制文件。
确认当前支持的目标平台组合
Go 官方支持的 GOOS 和 GOARCH 组合有限，不是所有操作系统+架构都能任意组合。可通过以下命令查看当前 Go 版本支持的全部有效组合：
go tool dist list
输出类似 darwin/amd64、linux/arm64、windows/386 等。注意：GOOS=windows 时默认生成 .exe 后缀；GOOS=linux 不会自动链接 glibc，适合容器部署。
立即学习“go语言免费学习笔记（深入）”；
windows-shell
下载
Windows 命令行编码与兼容规范。涵盖 GBK/UTF-8 编码、PowerShell/pwsh 互操作、Python/Node.js、Git 配置及代码生成规则。适用于 Windows 10/11 + MSYS2/Git Bash 环境下的所有命令行操作。
临时设置 GOOS 和 GOARCH 编译
最常用方式是通过命令行一次性指定，不影响当前 shell 环境：
- 编译 Linux ARM64 可执行文件：
GOOS=linux GOARCH=arm64 go build -o app-linux-arm64 main.go - 编译 Windows AMD64 程序：
GOOS=windows GOARCH=amd64 go build -o app.exe main.go - 编译 macOS Intel 64 位：
GOOS=darwin GOARCH=amd64 go build -o app-darwin-amd64 main.go
Windows 用户若用 PowerShell，需改用：$env:GOOS="windows"; $env:GOARCH="amd64"; go build -o app.exe main.go
设置全局或会话级环境变量
若频繁编译同一平台，可将变量设为环境变量（推荐仅限开发会话，避免影响日常构建）：
- Bash/Zsh（Linux/macOS）：
export GOOS=linux; export GOARCH=arm64 - PowerShell（Windows）：
$env:GOOS="linux"; $env:GOARCH="arm64" - cmd（Windows）：
set GOOS=linux && set GOARCH=arm64
设置后，后续所有 go build 命令都会默认使用该组合，直到变量被覆盖或终端关闭。
注意事项与常见问题
跨平台编译虽方便，但需留意几个关键点：
-
CGO 默认禁用：交叉编译时
CGO_ENABLED=0是默认行为。若项目依赖 C 代码（如 SQLite、OpenSSL），需提前安装对应平台的 C 工具链，并显式启用：CGO_ENABLED=1 GOOS=linux GOARCH=arm64 go build -
系统调用兼容性：使用
syscall或golang.org/x/sys时，务必检查对应平台是否支持相关函数，否则编译可能通过但运行失败。 -
路径分隔符与文件权限：
os.PathSeparator、os.FileMode等行为随GOOS变化，硬编码反斜杠或 Unix 权限可能导致跨平台异常。
