Debian包构建问题：pbuilder/PPA无法将文件部署至/opt目录

这种本地构建正常、干净环境构建出问题的情况，几乎都是构建系统没明确收到“要把哪些文件放到/opt”的指令——毕竟pbuilder和PPA是完全隔离的干净环境，不会自动识别你本地的文件结构。下面是一步步排查和解决的方法：

1. 检查debian/install配置文件（最常见原因） #

dh_make生成的模板默认不会自动处理/opt目录的文件，你需要手动创建或编辑debian/install文件，明确告诉dh_install工具要复制哪些文件到目标路径。

举个例子：如果你的项目根目录下有个myapp文件夹，里面是要部署到/opt/myapp的所有文件，那debian/install应该写成：

myapp/* /opt/myapp/

• 注意：目标目录必须以/结尾，确保工具识别为目录；源路径是相对于你运行debuild的包顶层目录的路径，一定要准确。

如果你的包有多个二进制组件，还可以为每个组件单独创建debian/<package-name>.install文件，比如debian/myapp-core.install。

2. 确认debian/rules没有覆盖dh_install的行为 #

打开debian/rules，如果里面有override_dh_install:的自定义规则，很可能你不小心跳过了默认的文件安装步骤。

• 如果没有特殊需求，直接删掉这个override规则，保留默认的dh sequencer配置：

  %:
          dh $@
  

  这样dh会自动执行所有默认构建步骤，包括读取debian/install并处理文件复制。
• 如果确实需要自定义dh_install，要确保在override里包含正确的安装命令，比如：

  override_dh_install:
          dh_install myapp/* /opt/myapp/
  

3. 查看构建日志定位具体错误 #

用pbuilder构建时，一定要保存日志，搜索dh_install相关的输出。比如运行：

pbuilder build your_package.dsc 2>&1 | tee build.log

然后在build.log里找dh_install的日志，常见的错误提示有：

• no files found matching "myapp/*"：说明源文件路径写错了，或者构建过程中源文件没被生成（比如编译步骤漏了）。
• unable to create directory /opt/myapp：虽然dh_install会自动创建目录，但如果权限有问题，可能需要在debian/postinst里手动创建并设置权限（不过这种情况很少见）。

4. 本地验证二进制包内容 #

先在本地用debuild -us -uc -b构建二进制包，然后用以下命令查看包里的文件结构：

dpkg-deb -c your_package_version_arch.deb

如果这个本地构建的deb里也没有/opt下的文件，那问题肯定出在debian目录的配置上，和pbuilder/PPA无关；如果本地deb里有，那再检查pbuilder环境是否拉取了所有必要的源文件（比如是否有文件被.gitignore排除，或者构建依赖没安装导致文件没生成）。

最后提醒 #

PPA构建的本质和pbuilder一致，都是干净环境，所以解决了pbuilder的问题，PPA自然就能正常工作。核心就是让构建系统明确知道要复制哪些文件到/opt，不要依赖本地环境的“隐式”文件存在。

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