如何从自有Git仓库构建Debian软件包？

核心需求匹配工具推荐 #

1. debhelper + git-dch #

这是最贴合你需求的轻量化组合，无需复杂的上游tar包流程，直接基于Git仓库自动生成changelog和版本信息：

• 自动生成规范changelog：git-dch（属于devscripts包）可直接从Git提交记录生成符合DEB标准的debian/changelog，常用命令：

  git-dch --release --auto --git-log=--no-merges
  

  参数说明：--release标记为正式发布版本，--auto自动推导版本号，--git-log=--no-merges跳过合并提交，让changelog更简洁。
• 关联Git标签作为版本：git-dch会自动识别Git标签，结合git describe --tags的逻辑生成DEB兼容的版本号（例如1.2.3-1，其中1.2.3是Git标签，-1为debian修订号）。
• 配合dpkg-buildpackage构建：生成changelog后，直接执行dpkg-buildpackage -us -uc即可完成构建（-us -uc跳过签名环节，适合个人项目）。

2. git-buildpackage简化用法 #

你觉得git-buildpackage复杂是因为它默认适配上游+debian分支的场景，但自有项目可以简化使用：

• 无需单独维护上游tar包，直接在主分支中保留debian目录即可。
• 使用命令gbp buildpackage --git-export-dir=../build --git-no-create-orig，跳过生成上游tar包的步骤，直接基于当前Git仓库内容构建。
• 同样可搭配git-dch生成changelog，版本号依然从Git标签自动获取。

基础操作流程（以debhelper+git-dch为例） #

1. 安装依赖工具：

   sudo apt install devscripts debhelper dpkg-dev
   

2. 在项目根目录初始化debian目录结构：

   dh_make --createorig -s -y
   

   --createorig会生成初始的orig.tar.gz，后续构建时可自动更新。
3. 配置debian/control文件：修改Package、Description等字段匹配你的项目，Version字段可先填占位符，后续由git-dch自动覆盖。
4. 生成changelog并构建DEB包：

   git-dch --release --auto
   dpkg-buildpackage -us -uc
   

   执行完成后，DEB包会生成在项目的上级目录中。

额外实用技巧 #

• 自定义changelog格式：可在项目根目录创建.git-dch配置文件，调整提交信息的提取规则，比如只提取包含特定关键字的提交记录。
• 手动微调版本号：如果需要在Git标签基础上增加修订号（如1.2.3-2），可执行git-dch --release --auto --new-version=1.2.3-2。
• 忽略构建产物：在.gitignore中添加debian/files、debian/*.log、*.deb、*.tar.xz等规则，避免Git跟踪临时构建文件。

内容的提问来源于stack exchange，提问作者ketil