Golang在Ubuntu上打包步骤

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

一 准备环境

• 安装 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）
  • export GOROOT=/usr/local/go
  • export GOPATH=$HOME/go
  • export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
  • 使配置生效：source ~/.bashrc
• 验证安装：go version 应输出版本号

二 本地构建可执行文件

• 进入项目根目录（包含 main.go 或模块根目录）
• 基本构建：go build -o myapp
• 指定输出目录：go build -o bin/myapp
• 常用构建优化（静态链接、适用于大多数服务器场景）：
  • CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -a -installsuffix cgo -o bin/myapp
• 运行测试：./myapp

三 交叉编译多平台

• 常用组合示例（在同一台 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 以获得静态二进制，便于跨发行版运行
  • 如需更多架构（如 arm64），替换 GOARCH 即可

四 产物压缩与归档

• 使用 UPX 减小体积
  • 安装：sudo apt-get install -y upx
  • 压缩：upx --best bin/myapp
• 打包归档（便于传输与发布）
  • tar.gz：tar czvf myapp-linux-amd64.tar.gz bin/myapp
  • zip：zip myapp-linux-amd64.zip bin/myapp

五 自动化与发布

• 使用 Makefile 简化构建
  • 示例：
    • BUILD_ENV := CGO_ENABLED=0 GOOS=linux GOARCH=amd64
    • go build -o bin/myapp $(BUILD_ENV) .
• 使用 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 .
• 使用 GoReleaser 做多平台构建与发布
  • 安装 goreleaser 后执行：goreleaser init 生成 .goreleaser.yml
  • 构建与发布：goreleaser release（可配置 GitHub/GitLab Releases 等）