Ubuntu 上打包 Golang 的关键注意事项
一 环境准备与基础检查
- 安装构建工具与 Go：建议安装 build-essential（提供 gcc/ld 等）与合适版本的 Go，并正确设置 GOROOT、GOPATH、PATH，确保命令行可直接执行 go 命令。
- 使用 Go Modules 管理依赖：在项目根目录执行 go mod init 与 go mod tidy，锁定依赖版本，避免“找不到包”等问题。
- 明确目标平台：在同一台 Ubuntu 主机上为不同系统/架构构建时，需通过环境变量控制构建目标。
二 构建与交叉编译要点
- 基本构建：在项目根目录执行 go build -o <main.go> 生成可执行文件。
- 交叉编译常用变量：设置 GOOS（目标系统）与 GOARCH（目标架构），如 linux/amd64、windows/amd64、darwin/amd64。
- 静态链接更可移植：纯 Go 项目建议 CGO_ENABLED=0 生成静态二进制，减少外部依赖；若必须使用 C 库，需启用 CGO 并准备对应交叉编译器。
- 减小体积与符号：使用 -ldflags “-s -w” 去除符号与调试信息；必要时再用 upx --best 进一步压缩。
- 指定输出目录：通过 -o /path/to/output/your_app 将产物放到指定目录，便于统一管理。
三 常见误区与排查
- 权限问题：构建后执行 chmod +x ，否则可能因权限不足无法运行。
- 误用 CGO 导致不可移植：交叉编译时忽略 CGO_ENABLED=0 常导致产物依赖本机 glibc/C 库，在目标机器上无法运行；纯 Go 场景建议禁用 CGO。
- 动态依赖检查：用 ldd 查看是否仍依赖外部 .so，若需要完全静态应回到静态构建。
- 静态编译报错定位：若启用 CGO 做静态链接失败（如缺 libxxx），需确认交叉编译链与库文件可用，并可通过设置 LD_LIBRARY_PATH 辅助查找；也可借助 opensnoop 等工具追踪链接阶段文件访问。
- 运行期库版本差异：目标机 glibc 版本过旧可能导致运行失败，尽量使用与目标机兼容的基础镜像或改为静态构建。
四 自动化与多平台交付
- 使用 Makefile 或 Shell 脚本 封装构建流程（设置 CGO_ENABLED、GOOS、GOARCH、-ldflags、-o 等），统一多环境构建命令。
- 多平台批量构建：使用 gox 等工具一键产出 linux/amd64、windows/amd64、darwin/amd64 等多平台产物，命名规范便于分发。
- 容器化交付：采用多阶段 Dockerfile，如构建阶段用 golang:1.16 编译，运行阶段用 scratch 或 alpine 减小镜像体积，提升可移植性与一致性。
五 实用命令清单
- 静态构建 Linux amd64：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags “-s -w” -o bin/myapp main.go && upx --best bin/myapp
- 交叉编译 Windows amd64：
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o bin/myapp.exe main.go
- 查看动态依赖：
ldd bin/myapp
- 赋予执行权限：
chmod +x bin/myapp
- 多平台构建（需先 go install github.com/mitchellh/gox@latest）：
gox -osarch=“linux/amd64 windows/amd64 darwin/amd64” -output=“dist/{{.OS}}_{{.Arch}}/{{.Dir}}”