Ubuntu打包Golang有哪些步骤

我从一个老的Go项目说起。在Ubuntu上打包Golang应用，第一步当然是把Go编译器装好。怎么装？最简单的方式就是通过系统包管理器，一条命令搞定，省心省力。

sudo apt update && sudo apt install golang-go -y

装完之后，顺手验证一下：

go version

如果看到go version go1.21.0 linux/amd64这样的输出，就说明环境已经就绪了。

依赖管理：Go Modules

现在Go生态里，依赖管理基本都靠Go Modules——从Go 1.11开始原生支持，推荐直接使用。在项目根目录下运行：

go mod init <项目名称>

举个例子：

go mod init myapp

这会在项目目录里生成一个go.mod文件，记录项目依赖及其版本。接着执行：

go mod tidy

这个命令会自动补齐缺失的依赖，同时清理掉不再需要的部分，确保依赖树干净整洁。

编译：从源码到可执行文件

进入包含main.go的项目目录，执行go build：

go build -o <输出文件名> main.go

比如：

go build -o myapp main.go

当前目录下就会出现一个名为myapp的可执行文件（Linux下没有后缀名）。

优化：让二进制文件更“干净”

静态编译

默认情况下，Go程序可能会依赖系统的动态链接库（比如libc）。如果打算把程序扔到Alpine、Scratch这类轻量级镜像里去跑，最好启用静态编译，提高可移植性：

CGO_ENABLED=0 go build -o myapp main.go

CGO_ENABLED=0就是告诉编译器，别碰C代码，生成一个纯静态的二进制文件。

压缩体积

如果想进一步压缩文件体积，可以考虑用upx工具：

sudo apt install upx-ucl -y
upx --best myapp

这个工具可以把文件体积压缩掉50%到70%，比如一个10MB的myapp，压缩后可能只有3MB左右。

打包分发：打包成tar

如果需要把应用和依赖一起分发，用tar打个包就行：

tar -czvf myapp.tar.gz myapp

这样会生成一个myapp.tar.gz压缩包，里面包含可执行文件。对方只需要tar -xzvf myapp.tar.gz解压后就能直接运行。

跨平台编译：一份代码，到处编译

要是想为Windows、macOS或者ARM架构（比如树莓派）编译，可以通过GOOS和GOARCH环境变量实现：

# 编译Windows 64位可执行文件
GOOS=windows GOARCH=amd64 go build -o myapp.exe main.go

# 编译macOS 64位可执行文件
GOOS=darwin GOARCH=amd64 go build -o myapp main.go

# 编译ARM架构可执行文件（如树莓派）
GOOS=linux GOARCH=arm64 go build -o myapp main.go

需要留意的是，跨平台编译时部分依赖可能需要额外配置（比如C库）。静态编译（CGO_ENABLED=0）可以大幅降低这类兼容性问题。

容器化部署：Docker多阶段构建

为了让应用在不同环境里表现一致，Docker容器化几乎是标准做法。下面是一个多阶段构建的Dockerfile示例，它先编译出一个静态二进制文件，再把它塞进一个scratch镜像里：

# 构建阶段：使用官方Go镜像编译
FROM golang:latest AS builder
WORKDIR /app
COPY . .
RUN CGO_ENABLED=0 go build -o /app/main .

# 最终阶段：使用scratch镜像（无额外依赖）
FROM scratch
COPY --from=builder /app/main /main
ENTRYPOINT ["/main"]

构建并运行容器：

docker build -t myapp .
docker run -d -p 8080:8080 myapp

scratch镜像体积极小（几MB），非常适合Kubernetes这类云原生环境。如果后期需要调试，也可以换成alpine镜像，再添上tzdata、ca-certificates这些基础工具。

以上步骤基本覆盖了Ubuntu上打包Golang应用的核心流程。具体项目里，可以根据需求选择是否加入静态编译、压缩或容器化这些优化步骤。