如何用Ubuntu打包Golang项目

如何在Ubuntu上打包Golang项目

在Ubuntu上打包Golang项目，核心步骤包括基础编译、跨平台构建、产物优化、自动化以及分发。下面从环境准备到最终交付，逐步拆解，完成完整流程。

1. 前置准备：安装Go环境与项目初始化

首先，确保Ubuntu系统已安装Go语言环境，建议使用1.20及以上版本。若未安装，可通过以下命令快速完成：

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

安装后验证版本：

go version

如果项目尚未初始化依赖，先执行go mod tidy自动下载并整理依赖：

cd /path/to/your/golang/project
go mod tidy

2. 基础打包：生成可执行文件

在项目根目录下，使用go build命令即可生成可执行文件。默认在当前目录生成与项目同名的二进制文件（例如myapp）：

go build -o myapp

注意：-o参数用于指定输出文件名。若项目入口为main.go，直接运行上述命令即可。

3. 跨平台打包：为不同系统生成可执行文件

Go的交叉编译功能非常强大，仅需设置GOOS（目标操作系统）和GOARCH（目标架构）两个环境变量。常见组合如下：

• Linux 64位（默认）：

  GOOS=linux GOARCH=amd64 go build -o myapp-linux

• Windows 64位：

  GOOS=windows GOARCH=amd64 go build -o myapp.exe

• macOS 64位：

  GOOS=darwin GOARCH=amd64 go build -o myapp-darwin

若希望生成的二进制文件完全不依赖外部动态库（例如部署到容器中），建议添加CGO_ENABLED=0禁用CGO：

CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp-linux

4. 产物优化：压缩可执行文件体积

编译出的二进制文件体积通常较大，不利于分发。此时可使用upx工具显著压缩体积。先安装：

sudo apt install upx -y

然后压缩：

upx --best myapp-linux

使用--best最高压缩率后，文件体积可减少50%～70%，效果明显。

5. 自动化打包：使用Makefile或Shell脚本

每次手动输入命令较为繁琐，建议编写脚本实现自动化。以下提供两种常见方式：Makefile和Shell脚本。

（1）Makefile方式

在项目根目录创建Makefile，内容如下：

GO := go
PROJECT_PATH := $(shell pwd)
OUTPUT_NAME := myapp
BUILD_TARGET := $(PROJECT_PATH)/bin/$(OUTPUT_NAME)
BUILD_ENV := CGO_ENABLED=0 GOOS=linux GOARCH=amd64

all: build

build:
	$(GO) build -o $(BUILD_TARGET) $(BUILD_ENV) $(PROJECT_PATH)

clean:
	rm -f $(BUILD_TARGET)

之后运行make即可自动编译，make clean清理产物，十分便捷。

（2）Shell脚本方式

创建build.sh文件，内容如下：

#!/bin/bash

GO := go
PROJECT_PATH := $(shell pwd)
OUTPUT_NAME := myapp
BUILD_TARGET := $(PROJECT_PATH)/bin/$(OUTPUT_NAME)
BUILD_ENV := CGO_ENABLED=0 GOOS=linux GOARCH=amd64

build() {
	$(GO) build -o $(BUILD_TARGET) $(BUILD_ENV) $(PROJECT_PATH)
}

clean() {
	rm -f $(BUILD_TARGET)
}

case "$1" in
	build)
		build
		;;
	clean)
		clean
		;;
	*)
		echo "Usage: $0 {build|clean}"
		exit 1
		;;
esac

赋予执行权限后直接运行：

chmod +x build.sh
./build.sh build   # 编译
./build.sh clean   # 清理

6. 分发：打包为压缩文件

可执行文件生成后，通常打包为tar.gz格式以便传输：

tar -czvf myapp-linux.tar.gz myapp-linux

参数说明：-c创建压缩包，-z使用gzip压缩，-v显示过程，-f指定文件名。一气呵成。

7. 高级：使用Docker打包（推荐）

在云原生时代，将项目打包为容器镜像已是标准做法，尤其适合云部署。创建Dockerfile：

# 构建阶段：使用golang镜像编译
FROM golang:1.22-alpine AS builder
WORKDIR /app
COPY . .
RUN go build -o myapp .

# 运行阶段：使用轻量级alpine镜像
FROM alpine:latest
WORKDIR /app
COPY --from=builder /app/myapp .
CMD ["./myapp"]

然后构建镜像并运行：

docker build -t myapp:latest .
docker run -d -p 8080:8080 myapp:latest   # 端口映射根据项目调整

这样打包出的镜像体积小巧、可移植，可直接部署到任何支持Docker的环境。

通过以上步骤，在Ubuntu上完成Golang项目的打包、优化及分发，基本可覆盖大多数场景。从单机测试到生产部署，均能找到对应方案。