使用stdeb将Python包转为Debian包时[Errno 2]错误的原因及解决
2026-5-15
问题诊断与修复方案
Hey，我之前也踩过stdeb打包的坑，结合你的报错回溯和项目情况，帮你梳理下可能的原因和对应的解决办法：
1. stdeb版本兼容性问题
旧版本的stdeb在处理sdist后的临时目录时，偶尔会出现生命周期管理bug——比如提前删掉了临时目录，导致后续的清理步骤找不到文件报Errno 2。这是我遇到过最常见的原因。
修复步骤：
- 先卸载当前的stdeb：
pip uninstall stdeb -y - 安装最新稳定版：
pip install --upgrade stdeb - 如果最新版还是有问题，可以试试这个经过验证的稳定旧版本：
pip install stdeb==0.10.0
2. setup.py文件声明不完整
虽然python setup.py install能正常运行，但stdeb对打包文件的完整性要求更严格。比如你的README.txt如果没在setup.py里正确声明，可能会导致stdeb在复制文件时出现隐性异常，间接引发后续的目录删除错误。
修复步骤：
修改你的setup.py，确保所有必要文件都被包含：
from setuptools import setup, find_packages setup( name="run", version="0.0.1", packages=find_packages(), include_package_data=True, # 自动读取MANIFEST.in里的文件声明 entry_points={ 'console_scripts': [ 'run=run:main', # 可选，但有助于stdeb生成正确的命令行入口 ] }, # 其他原有的配置... )
然后在项目根目录新建一个MANIFEST.in文件，内容如下：
include README.txt
这样能确保sdist打包时不会漏掉README.txt，避免stdeb处理时出问题。
3. 临时目录权限或被占用
有时候系统临时目录权限不足，或者临时目录被其他进程（比如文件管理器、系统清理工具）提前删掉了，导致stdeb在清理阶段找不到目标目录。
修复步骤：
- 先手动清理项目下的临时文件：删除
run.egg-info、dist、deb_dist这些目录，然后重新运行打包命令。 - 或者指定自定义临时目录，确保你有读写权限：
export STDEB_TMPDIR=./my_temp_dir python setup.py --command-packages=stdeb.command bdist_deb
4. Entry Points配置异常
看你的回溯里有生成entry_points.txt的步骤，如果你的entry_points配置有问题（比如指向了不存在的函数），虽然import run; run.main()能正常运行，但stdeb在打包时的额外检查可能会触发隐性错误，间接导致目录删除失败。
修复步骤：
- 确保entry_points的配置和你的实际代码对应：如果main函数在
run/__init__.py里，那entry_points应该是'console_scripts': ['run=run:main']。 - 如果不需要entry_points，可以直接删掉setup.py里的这部分配置，再尝试打包。
终极备选方案
如果上面的方法都不行，可以手动分步打包：
- 先生成sdist包：
python setup.py sdist - 用stdeb生成dsc文件：
stdeb-run setup.py sdist_dsc（根据你的Python版本，可以加--with-python2=False --with-python3=True参数） - 进入生成的
deb_dist/run-0.0.1目录，运行dpkg-buildpackage -rfakeroot -uc -us生成deb包。
内容的提问来源于stack exchange，提问作者Keithx
相关产品推荐
相关产品推荐
