Golang在Ubuntu上打包步骤

数码系统

相机 win10

测评 win11

手机智车

华为 Tesla

小米理想

苹果蔚来

游戏软件

LOL 抖音

原神微信

当前位置：首页

编程语言

Golang在Ubuntu上打包步骤

热心网友时间：2026-05-04

转载

在 Ubuntu 上打包 Golang 程序的标准流程

Golang在Ubuntu上打包步骤

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

万事开头先搭台。打包之前，得确保你的 Ubuntu 系统已经装好了 Go 语言环境。这事儿通常有两种路子，选一个顺手的就行。

安装 Go（两种常用方式，二选一）
- 使用发行版仓库安装：最省心的方法，一条命令搞定：sudo apt-get update && sudo apt-get install -y golang。适合快速上手，不过仓库里的版本可能不是最新的。
- 使用官方安装包：追求最新稳定版的话，推荐这个。去 golang.org/dl 下载 Linux 版本的压缩包，解压到 /usr/local/go 目录下，然后把 /usr/local/go/bin 这个路径加到你的系统 PATH 环境变量里。
配置环境变量（写入 ~/.bashrc 或 ~/.zshrc）
- 为了让系统知道 Go 在哪，以及你的工作区路径，通常需要设置这几个变量：
```
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
```
- 配置好后，别忘了执行 source ~/.bashrc（或用你的 shell 配置文件）让改动立刻生效。
验证安装：最后一步，打开终端输入 go version。如果屏幕上蹦出了具体的版本号，恭喜你，环境准备就绪。

环境齐备，接下来就是让代码“跑起来”变成可执行文件。这个过程，我们称之为构建。

首先，进入项目根目录，也就是包含 main.go 文件或者 go.mod 文件的目录。
基本构建：最简单的命令是 go build -o myapp。这里的 -o 参数指定了输出文件的名字。
指定输出目录：想让产物更规整？可以指定输出到特定目录，比如 go build -o bin/myapp。
常用构建优化（静态链接、适用于大多数服务器场景）：
- 对于需要部署到服务器的场景，我们往往希望生成一个静态链接的、不依赖系统库的二进制文件。这样可以避免目标服务器环境差异带来的问题。一个经典的命令组合是：CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -a -installsuffix cgo -o bin/myapp。简单解释一下：CGO_ENABLED=0 禁用 CGO 以实现纯静态编译；GOOS 和 GOARCH 指定目标操作系统和架构；-a 强制重新编译所有包。
运行测试：构建完成后，不妨在本地运行一下 ./myapp，确保程序行为符合预期。

Golang 的一大魅力就在于其强大的交叉编译能力。你完全可以在 Ubuntu 系统上，轻松生成能在 Windows、macOS 或其他架构 Linux 上运行的程序。

常用组合示例（在同一台 Ubuntu 上直接生成多平台二进制）
- Linux amd64：CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o bin/myapp-linux-amd64
- Windows amd64：CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o bin/myapp-windows-amd64.exe
- macOS amd64：CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -o bin/myapp-darwin-amd64
说明
- 对于纯 Go 语言写的项目，强烈建议设置 CGO_ENABLED=0。这样生成的二进制文件是静态链接的，几乎可以在任何同架构的 Linux 发行版上运行，免去了处理动态库依赖的麻烦。
- 如果需要支持其他 CPU 架构，比如现在越来越常见的 arm64（例如苹果 M 系列芯片或树莓派），只需将上面命令中的 GOARCH 参数替换为 arm64 即可。

生成的可执行文件，有时候体积不小。为了便于网络传输或发布，我们通常还需要做两件事：压缩和打包。

使用 UPX 减小体积
- 安装：sudo apt-get install -y upx
- 压缩：upx --best bin/myapp。UPX 是一个高效的可执行文件压缩工具，通常能将文件体积减小 50%-70%，而且不影响正常运行。
打包归档（便于传输与发布）
- tar.gz：在 Linux 世界最通用的格式，命令如 tar czvf myapp-linux-amd64.tar.gz bin/myapp。
- zip：考虑到跨平台兼容性，zip 格式也是个好选择：zip myapp-linux-amd64.zip bin/myapp。

手动执行命令毕竟繁琐，尤其是项目迭代频繁时。将构建和发布流程自动化，是提升效率、保证一致性的关键一步。

使用 Makefile 简化构建
- 创建一个 Makefile 文件，把常用的构建命令封装起来。例如：
```
BUILD_ENV := CGO_ENABLED=0 GOOS=linux GOARCH=amd64
build:
    go build -o bin/myapp $(BUILD_ENV) .
```
  之后只需要运行 make build 即可完成构建。
使用 Docker 多阶段构建（镜像更小、分发一致）
- Docker 能确保构建环境完全一致，并且通过多阶段构建可以生成极其精简的最终镜像。一个典型的 Dockerfile 示例如下：
```
FROM golang:1.22 AS builder
WORKDIR /app
COPY . .
RUN go mod download
RUN CGO_ENABLED=0 GOOS=linux go build -o myapp .

FROM scratch
COPY --from=builder /app/myapp /myapp
ENTRYPOINT ["/myapp"]
```
- 使用 docker build -t myapp:latest . 命令即可构建出镜像。基于 scratch（空镜像）的最终镜像，只包含你的可执行文件，体积非常小。
使用 GoReleaser 做多平台构建与发布
- 对于需要发布到 GitHub、GitLab 等平台的开源项目，GoReleaser 是神器。安装后，先在项目根目录执行 goreleaser init 生成配置文件 .goreleaser.yml。
- 之后，运行 goreleaser release 命令，它可以自动帮你完成多平台交叉编译、打包、生成校验和、并发布到代码托管的 Releases 页面，一站式解决所有发布流程。