在 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 等）
