Golang 在 CentOS 上打包的注意事项

环境准备与基础配置

在 CentOS 上部署 Golang 应用，有几个环节是绕不开的。先把基础打扎实，后面才不至于手忙脚乱。

• 安装 Go：CentOS 下装 Go 有两种常见方式——要么直接通过包管理器 yum install golang 一把搞定，要么去官网下载 .tar.gz 手动解压到 /usr/local/go。别忘了把 GOROOT、GOPATH、PATH 这些环境变量写进 ~/.bashrc 或 /etc/profile，然后 source 一下让它们生效。装没装对？跑一句 go version 就能验证。
• 依赖管理：现在都推荐用 Go Modules 来管理依赖，先 go mod init 再 go mod tidy，确保 go.mod 和 go.sum 保持一致。不然换台机器构建结果就可能不一样，踩坑的概率直线上升。
• 资源与权限：确认二进制文件、配置文件、静态资源这些路径都没问题。上传到服务器后，记得给可执行文件加上执行权限：chmod +x 是基本功。

构建与交叉编译要点

• 目标平台：在 CentOS 上构建 Linux 二进制，最常用的组合就是 GOOS=linux GOARCH=amd64。如果需要跨架构，写个脚本批量设置 GOOS 和 GOARCH 就行，省时省力。
• CGO 取舍：如果项目是纯 Go 代码，建议把 CGO_ENABLED=0 设为 0，这样编译出来的是静态二进制文件，不依赖外部动态库，部署起来最省心。但如果项目里用到了 CGO（比如调用 C 库），那就得老老实实装上 gcc 等工具链，并且目标系统上的 glibc 或 C 库版本必须匹配，否则启动时会翻车。
• 静态链接与体积优化：常用的组合拳是 CGO_ENABLED=0 go build -ldflags "-s -w"，去掉符号表和调试信息，能让体积小一截。如果需要彻底的静态链接，可以加上 -extldflags '-static'，但注意这只在 CGO 禁用时才有意义。
• 并行与缓存：用 -p 参数并行构建能提速，时不时用 go clean -cache 清理一下缓存，避免构建环境越来越臃肿。

运行与进程管理

• 后台运行与日志：开发环境或简单部署时，用 nohup ./app & 把程序扔到后台，再重定向输出到日志文件，方便排查问题。
• 优雅启停：生产环境千万别上来就 kill -9，优先用 kill -15 发 SIGTERM 信号，让程序完成清理再退出。更稳妥的做法是配合 systemd 来管理进程，开机自启、重启策略、日志采集全搞定。
• 配置热更新：修改 .env 或 config.ini 这类配置文件后，通常需要重启服务才能生效。发布时最好规划好滚动更新或蓝绿切换，把服务中断时间降到最低。

交付与多架构打包实践

• 多架构产物：为 amd64、arm64 等架构分别构建，并在文件名上标明 OS 和架构（比如 app-linux-amd64）。在制品库或发布页面上清晰标注，避免用错。
• 容器化交付：推荐用 Docker 多阶段构建，在构建阶段编译出二进制，在运行阶段用 alpine 这类轻量镜像。这样镜像体积小，可移植性也强。
• 可选压缩：如果对体积有极致要求，可以试试 UPX 压缩（比如 upx --best），能进一步压缩二进制。代价是启动时间会稍微变长，而且调试信息会丢失，按需使用就好。

常见坑与排查清单

• 动态库依赖导致启动失败：这是最常碰到的坑。如果没有禁用 CGO，部署到目标系统后必须确保 glibc 或 C 库版本兼容。跨大版本迁移 glibc 时，最简单的方式就是直接用 CGO_ENABLED=0 编出静态二进制，一劳永逸。
• 权限与安全：不要图省事直接 chmod 777，遵循最小权限原则设置可执行文件和配置文件的访问权限。
• 资源未打包：如果用 go-bindata、pkger 这类工具把静态资源嵌入二进制，构建时记得确认资源已经正确打包进去，否则程序运行时会找不到文件。
• 环境变量未生效：修改了 ~/.bashrc 或 /etc/profile 后没 source，会导致 go 命令或构建变量不可用，排查时先检查这一步。
• 架构不匹配：构建时 GOARCH 设成了 amd64，但目标机器是 arm64，运行时会直接报 exec format error。核对好架构再部署。