GOOS和GOARCH环境变量决定编译目标平台,设置后执行go build即可跨平台编译;需注意大小写规范及本地Go版本对目标平台的支持情况。

GOOS 和 GOARCH 环境变量决定编译目标平台
Go 原生支持跨平台编译,不需要安装多个 SDK 或虚拟机。关键在于正确设置 GOOS(目标操作系统)和 GOARCH(目标 CPU 架构)环境变量,再执行 go build 即可生成对应平台的二进制文件。
常见组合示例:
GOOS=windows GOARCH=amd64 go build -o app.exe main.goGOOS=linux GOARCH=arm64 go build -o app-linux-arm64 main.goGOOS=darwin GOARCH=arm64 go build -o app-macos main.go
注意:GOOS 值必须小写(windows 不是 Windows),GOARCH 区分大小写但通常全小写(arm64、amd64)。macOS 上若要生成 Intel 版本,需设为 GOARCH=amd64,即使你用的是 M1/M2 芯片。
交叉编译前先确认本地 Go 是否支持目标平台
不是所有 Go 版本都默认支持全部 GOOS/GOARCH 组合。例如旧版 Go(darwin/arm64 支持不完整;某些嵌入式架构(如 GOARCH=riscv64)需 Go 1.21+ 才稳定支持。
立即学习“go语言免费学习笔记(深入)”;
运行 go tool dist list 可查看当前 Go 安装支持的所有平台组合。输出中包含 linux/amd64、windows/386 等条目,没列出的组合大概率会报错 build constraints exclude all Go files 或 cannot find package "syscall"。
如果你需要支持 android 或 ios,还需额外安装 NDK / Xcode 工具链,并启用 CGO_ENABLED=1 —— 这类场景已超出纯 Go 编译范畴,实际构建会更复杂。
发卡宝是一个专业的软件卡密等虚拟商品在线交易平台,拥有多种兑换方式,费率低,结算快,正规企业平台一直稳定运营,24小时不间断提供自动发卡服务。【模板说明】试用版自带一套模板(响应式)【环境支持】PHP环境 / 200M或以上空间大小 / 开启父路径 / 设置index.php为默认首页 / 目录写入权限需要开启【数据库】MySQL【安装步骤】将文件上传至空间目录,运行“http://域名/inst
CGO_ENABLED=0 是跨平台静态编译的关键开关
默认开启 CGO 时,Go 会链接系统 C 库(如 glibc),导致生成的二进制无法在其他 Linux 发行版或 musl 系统(如 Alpine)上运行。解决方法是禁用 CGO:
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -a -ldflags '-s -w' -o app-linux main.go
说明:
-
CGO_ENABLED=0:强制纯 Go 实现(禁用 net、os/user 等依赖 libc 的包) -
-a:重新编译所有依赖(含标准库),确保无残留 cgo 引用 -
-ldflags '-s -w':剥离调试符号和 DWARF 信息,减小体积
副作用:部分功能受限,比如 user.Lookup 在 CGO_ENABLED=0 下会返回错误;DNS 解析退回到纯 Go 实现(可能慢于系统 resolver)。
Windows 上生成 macOS 二进制?别试了
Go 官方明确不支持从 Windows 构建 darwin/* 目标(即 macOS 二进制)。即使设置了 GOOS=darwin,也会报错 cannot build darwin binary on windows。同理,Linux 主机也不能直接构建 ios 或 darwin 产物。
真正可行的方案只有两种:
- 在 macOS 机器上构建所有
darwin/*和ios/*目标 - 用 GitHub Actions / GitLab CI 等服务,在 macOS runner 上自动触发构建(例如使用
runs-on: macos-latest)
试图用 Docker 模拟 macOS 环境是徒劳的——内核和系统调用层完全不兼容,不是换个 rootfs 就能绕过的。









