Golang 在 CentOS 上打包的注意事项

一 环境准备与基础配置

• 安装 Go：在 CentOS 上可通过包管理器安装（如 yum install golang），或使用官方 .tar.gz 解压到 /usr/local/go；配置环境变量（如 GOROOT、GOPATH、PATH）到 ~/.bashrc 或 /etc/profile 并执行 source 使其生效。完成后用 go version 验证。
• 依赖管理：使用 Go Modules（go mod init/tidy）管理依赖，确保 go.mod/go.sum 一致，避免在不同机器上构建结果不一致。
• 资源与权限：确认二进制、配置、静态资源路径正确；上传后给可执行文件添加执行权限（如 chmod +x）。

二 构建与交叉编译要点

• 目标平台：在 CentOS 上构建用于 Linux 的二进制，常用 GOOS=linux GOARCH=amd64；如需多架构，脚本化设置 GOOS/GOARCH 批量构建。
• CGO 取舍：纯 Go 项目建议 CGO_ENABLED=0 生成静态二进制，减少外部依赖；若项目使用 CGO（调用 C 库），需安装 gcc 等工具链并启用 CGO，且目标系统需具备相应 glibc/C 库 版本。
• 静态链接与体积优化：常用组合为 CGO_ENABLED=0 go build -ldflags “-s -w” 去除符号与调试信息；在需要时可使用 -extldflags ‘-static’ 做完全静态链接（仅在 CGO 禁用时有效）。
• 并行与缓存：通过 -p 并行构建、使用 go clean -cache 清理缓存，加快构建与发布流程。

三 运行与进程管理

• 后台运行与日志：开发/简单部署可用 nohup ./app & 并将输出重定向到日志文件，便于排查问题。
• 优雅启停：生产环境避免 kill -9，优先 kill -15 让程序完成清理后退出；配合 systemd 管理服务更可靠（开机自启、重启策略、日志采集）。
• 配置热更新：修改 .env/config.ini 等通常需要重启服务才生效，发布时规划滚动或蓝绿切换以减少中断。

四 交付与多架构打包实践

• 多架构产物：为 amd64/arm64 等分别构建并命名区分（如 app-linux-amd64），在制品库或发布页清晰标注 OS/ARCH。
• 容器化交付：使用 Docker 多阶段构建，在构建阶段编译，运行阶段使用 alpine 等轻量基础镜像，显著减小镜像体积并提升可移植性。
• 可选压缩：对二进制使用 UPX 压缩（如 upx --best）进一步降低体积，注意可能带来启动耗时小幅增加与调试信息丢失。

五 常见坑与排查清单

• 动态库依赖导致启动失败：若未禁用 CGO，请确保目标系统 glibc/C 库 兼容；跨大版本 glibc 迁移时优先采用 CGO_ENABLED=0 的静态二进制。
• 权限与安全：避免使用 chmod 777，按最小权限原则设置可执行文件与配置文件的访问权限。
• 资源未打包：若使用 go-bindata/pkger 等将静态资源嵌入二进制，确认构建时资源已正确打包进可执行文件。
• 环境变量未生效：修改 ~/.bashrc 或 /etc/profile 后未 source，导致 go 或构建变量不可用。
• 架构不匹配：构建时 GOARCH 与目标机器不一致（如在 arm64 机器误用 amd64 二进制），运行会报 “exec format error”。