如何在Debian上构建Python包

在 Debian 上打包 Python 项目，说难也不难，但确实有不少细节需要注意。很多新手一上来就想着直接生成 .deb 文件，结果往往卡在依赖关系或者控制文件上。下面梳理了一套相对标准的操作流程，跟着走基本不会翻车。

1. 先把工具装齐
   打包之前，系统里得有几样必备工具：python3、python3-pip、build-essential、devscripts、dh-make、pbuilder、debuild 和 python3-setuptools。一行命令全部搞定：

   sudo apt-get update
   sudo apt-get install python3 python3-pip build-essential devscripts dh-make pbuilder debuild python3-setuptools

   注意，如果你的 Debian 版本比较老，某些包名可能略有差异，建议先用 apt-cache search 确认一下。

2. 用 dh_make 初始化包结构
   这是整个过程的骨架。执行 dh_make 时带上 --python 参数，它会自动生成适用于 Python 包的目录模板。你需要指定包名和版本号：

   dh_make --createorig --python --packagename=你的包名 --version=版本号

   命令执行后，当前目录下会多出一个文件夹，里面已经预置了 debian/ 目录和各种模板文件，后面大部分工作都围绕这个目录展开。

3. 把真正的代码放进去
   在生成的包结构里找到源码目录（通常与包名相同），把你写好的 Python 模块或脚本放进去。别忘了确保代码在 Python 环境里能正常跑——这一步如果出问题，后面所有工作都是白费。

4. 编辑控制文件——包的名片
   Debian 包的元数据全部写在 debian/ 目录下，核心文件有这几个：control（包名、版本、依赖关系、描述等）、changelog（版本更新记录）、copyright（版权信息）。其中 control 里的 Depends 字段特别重要，一定要把运行时需要的 Python 库准确列出来，否则安装后可能直接报错。

5. 执行构建命令
   一切就绪后，在包目录内运行：

   debuild -us -uc

   -us 和 -uc 的含义是不对源码包和二进制包进行 GPG 签名——如果你只是本地测试或内部使用，这一步可以省掉。构建完成后，在上一级目录会生成 .deb 文件。

6. 安装测试
   拿到 .deb 之后，别急着发出去，先在自己机器上装一遍试试：

   sudo dpkg -i ../你的包名_版本号_amd64.deb

   安装成功后运行一下主要功能，检查是否有缺少依赖或路径问题。如果发现依赖缺失，可以用 sudo apt-get install -f 自动补全。

7. 上传分发
   如果需要把包分享给更多人，最正规的途径是上传到 Debian 官方仓库。但这需要你拥有 Debian 开发者账号，并且严格遵守打包指南中的各种规范（比如 lintian 检查全部通过）。对于个人或团队内部使用，搭一个私有 APT 仓库可能是更省事的办法。

以上只是最基础的流水线。实际项目中如果涉及 C 扩展、系统级依赖、或者需要特殊的编译选项，打包流程会复杂不少。建议遇到具体情况时，顺手翻一下 Debian New Maintainers’ Guide，那里对每个细节都有详细解释。