为一个Golang项目添加跨平台编译的构建脚本-Golang-PHP中文网

为一个Golang项目添加跨平台编译的构建脚本

P粉602998670

发布： 2025-09-01 09:46:01

原创

675人浏览过

答案：通过设置GOOS和GOARCH环境变量，使用Shell脚本实现Go项目跨平台编译。脚本清理并创建dist目录，遍历指定平台和架构组合，生成带正确后缀的可执行文件，如myapp-windows-amd64.exe，并确保CGO_ENABLED=0以静态编译提升可移植性，适用于CI/CD集成。

为一个golang项目添加跨平台编译的构建脚本

在Golang项目中，跨平台编译是一个常见需求，比如从Mac或Linux构建Windows、macOS、Linux不同架构的可执行文件。Go原生支持交叉编译，只需设置目标平台的

GOOS

登录后复制

和

GOARCH

登录后复制

环境变量即可。我们可以通过编写一个简单的Shell脚本来自动生成多个平台的构建结果。

支持的常见平台和架构

Go支持多种操作系统和处理器架构组合。以下是一些常用的

GOOS

登录后复制

（操作系统）和

GOARCH

登录后复制

（架构）组合：

Windows:
```
GOOS=windows
```
登录后复制
,
```
GOARCH=amd64
```
登录后复制
或
```
386
```
登录后复制
macOS:
```
GOOS=darwin
```
登录后复制
,
```
GOARCH=amd64
```
登录后复制
或
```
arm64
```
登录后复制
Linux:
```
GOOS=linux
```
登录后复制
,
```
GOARCH=amd64
```
登录后复制
,
```
386
```
登录后复制
,
```
arm64
```
登录后复制
,
```
arm
```
登录后复制
等

创建构建脚本 build.sh

在项目根目录下创建一个名为

build.sh

登录后复制

的脚本文件，内容如下：

<font face="monospace"><br>#!/bin/bash<br><br>APP_NAME="myapp"<br>BUILD_DIR="dist"<br><br># 清理并创建输出目录<br>rm -rf $BUILD_DIR<br>mkdir -p $BUILD_DIR<br><br># 定义要构建的平台列表<br>PLATFORMS=("windows/amd64" "windows/386" \<br>           "darwin/amd64" "darwin/arm64" \<br>           "linux/amd64" "linux/386" "linux/arm64" "linux/arm")<br><br>for platform in "${PLATFORMS[@]}"; do<br>  GOOS=${platform%/*}<br>  GOARCH=${platform#*/}<br>  OUTPUT_NAME=$APP_NAME<br>  <br>  # Windows 可执行文件需要 .exe 后缀<br>  if [ $GOOS = "windows" ]; then<br>    OUTPUT_NAME+=".exe"<br>  fi<br>  <br>  echo "Building for $GOOS/$GOARCH..."<br>  CGO_ENABLED=0 GOOS=$GOOS GOARCH=$GOARCH go build \<br>    -o $BUILD_DIR/$OUTPUT_NAME-$GOOS-$GOARCH \<br>    .<br>  <br>  if [ $? -ne 0 ]; then<br>    echo "Failed to build for $GOOS/$GOARCH"<br>    exit 1<br>  fi<br>done<br><br>echo "Build complete. Files are in $BUILD_DIR/"<br></font>

登录后复制

赋予脚本执行权限：

立即学习“go语言免费学习笔记（深入）”；

<font face="monospace">chmod +x build.sh</font>

登录后复制

运行脚本：

一览AI编剧

创意生成+情节生成+脚本生成，AI编剧3步走，AI自动帮你搞定剧情！

查看详情

<font face="monospace">./build.sh</font>

登录后复制

脚本说明与使用建议

该脚本会生成类似以下的可执行文件：

```
dist/myapp-windows-amd64.exe
```
登录后复制
```
dist/myapp-darwin-amd64
```
登录后复制
```
dist/myapp-linux-arm64
```
登录后复制

每个文件对应一个平台，便于分发。

关键点：

CGO_ENABLED=0 确保静态编译，避免依赖外部C库，提升可移植性
脚本使用纯Go交叉编译，无需额外工具链
可按需修改
```
PLATFORMS
```
登录后复制
数组，只构建目标平台
建议将
```
dist
```
登录后复制
加入 .gitignore

基本上就这些。一个简单的Shell脚本就能搞定Go项目的多平台构建，方便CI/CD集成或发布不同系统的版本。不复杂但容易忽略的是输出文件命名和后缀处理，尤其是Windows平台。这个脚本覆盖了常见场景，可直接复用。

以上就是为一个Golang项目添加跨平台编译的构建脚本的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

Go语言生态系统：Java开发者工具链指南从Java生态到Go语言：核心工具与实践指南 Go语言与Java生态系统工具链的对应与实践指南 Go语言开发生态：Java背景开发者的迁移指南 Go与Java后端服务高效集成指南