Debian 打包 Golang 失败的排查与修复指南
一、快速定位与通用修复
- 先看完整报错：运行构建命令时加上**-e或查看/var/log/**与构建日志，优先定位首个报错行（如命令未找到、依赖缺失、测试失败等）。
- 确认 Go 工具链可用：在构建环境中执行go version；若报“go: Command not found”，安装系统包golang-go并验证：sudo apt-get update && sudo apt-get install -y golang-go；go version。必要时检查PATH是否包含**/usr/bin/go**。
- 清理并重试：执行go clean -cache -modcache，再重新构建；若使用 Makefile，确保其中的go build/clean等命令在构建环境中可执行。
- 若只是 Lintian 报错而非构建失败，可临时用dpkg-buildpackage -us -uc -b构建二进制包，或按需配置 Lintian 覆盖。
二、常见错误与对应修复
- 构建环境找不到 go 命令：安装golang-go；若你曾在用户环境设置过GOROOT/GOPATH，注意debuild可能在受限环境运行，确保这些变量在构建环境中也可用，或尽量使用发行版提供的 Go 包而非手动安装。
- 依赖解析或拉取失败：确认go.mod完整，网络可达公共模块代理；必要时在干净环境中执行go mod tidy，或在构建前准备依赖（如使用dh-make-golang生成模板并处理依赖）。
- 代码或测试失败：先用go vet、go fmt检查常见问题和格式；本地复现失败后修正，再打包。
- 缓存或旧版本导致异常：执行go clean -cache -modcache清理缓存；必要时升级到较新的 Go 版本或发行版包。
三、推荐打包路径与 debian/rules 示例
- 现代推荐方式：使用dh-golang简化 Go 打包流程，与gc编译器构建的程序兼容性更好。
- 模板生成：在项目根目录执行dh-make-golang，按提示生成**debian/**目录结构并完善控制文件与规则。
- 最小可用的 debian/rules（示例）：
#!/usr/bin/make -f
%:
dh $@ --buildsystem=golang --with=golang
- 构建命令：debuild -uc -us 或 dpkg-buildpackage -us -uc -b。
四、进阶处理与求助渠道
- 仅构建二进制包并绕过 Lintian：使用dpkg-buildpackage -us -uc -b；若仍需走 debuild，可在**debian/**下添加 Lintian 覆盖文件以忽略不适用的静态链接等警告。
- 查看官方构建日志：到buildd.debian.org检索对应包与架构的构建日志，对比环境差异与失败点。
- 社区求助：提供你的**debian/**目录关键文件（control、rules、changelog）、Go 版本、构建命令与首条报错，便于快速定位。
