Ubuntu打包Golang代码的方法

Ubuntu打包Golang代码的方法

一 准备环境

• 安装 Go（Ubuntu 仓库或官方安装包均可）：
  • 仓库安装：sudo apt-get update && sudo apt-get install golang
  • 安装后验证：go version
• 可选：配置环境变量（新版本通常无需显式设置 GOPATH/GOROOT）：
  • 写入到 ~/.bashrc：export PATH=$PATH:/usr/local/go/bin
  • 使配置生效：source ~/.bashrc
• 说明：Go 是静态编译语言，默认可直接生成可执行文件，适合在 Ubuntu 上打包分发。

二 本地构建与多平台交叉编译

• 本地构建（Linux amd64）：
  • go build -o myapp main.go
• 交叉编译常用组合（禁用 CGO 更易跨平台运行）：
  • Linux amd64：CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp
  • Windows 64位：CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o myapp.exe
  • macOS amd64：CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -o myapp
• 提示：若需更多架构（如 arm64），替换 GOARCH 即可；涉及 C 库时再考虑启用 CGO 并配置交叉编译器。

三 体积优化与产物打包

• 二进制压缩（UPX）：
  • 安装：sudo apt-get install upx
  • 压缩：upx --best myapp（可显著减小体积）
• 归档分发：
  • 压缩包：tar czvf myapp.tar.gz myapp config/
  • 传输与运行：
    • 解压：tar xzvf myapp.tar.gz
    • 赋权：chmod +x ./myapp
    • 运行：./myapp
• 适用场景：发布到多台服务器、CI 产物归档、外部分发等。

四 自动化与多平台批量构建

• 使用 Makefile 简化构建与清理：
  • 示例要点：
    • 设置变量：GO := go、BUILD_ENV := CGO_ENABLED=0 GOOS=linux GOARCH=amd64
    • 构建：$(GO) build -o bin/myapp $(BUILD_ENV) .
    • 清理：rm -f bin/myapp
  • 使用：make 或 make build / make clean
• 多平台批量构建工具（gox）：
  • 安装：go get github.com/mitchellh/gox
  • 一键多平台：gox -output="dist/{{.OS}}_{{.Arch}}/{{.Dir}}" .
• 适用场景：需要一次性产出 Linux/Windows/macOS 多平台产物的项目。

五 Docker 镜像打包与最小化交付

• 多阶段构建示例（生成极小镜像）：
  • Dockerfile：

    FROM golang:1.21 AS builder
    WORKDIR /app
    COPY . .
    RUN go mod download
    RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o myapp .
    
    FROM scratch
    COPY --from=builder /app/myapp /myapp
    ENTRYPOINT ["/myapp"]
    

  • 构建与运行：
    • 构建：docker build -t myapp:latest .
    • 运行：docker run --rm myapp:latest
• 说明：使用 scratch 基础镜像可获得最小体积；如需 shell 调试，可改用 alpine 并在构建阶段保留调试符号。