👉 项目官网:https://www.python-office.com/ 👈
👉 本开源项目的交流群 👈
大家好,这里是程序员晚枫。
最近在疯狂更新开源项目:python-office、poocr、potx-cloud、PyOfficeRobot等等。
也把我一直想改进的打包方式做了一个升级,今天给大家分享一下。
问题说明
这个问题来自打包,在打包发布的时候,老是在后台收到一个提示:
1 | DEPRECATION: Building 'python-office' using the legacy setup.py bdist_wheel mechanism, which will be removed in a future version. pip 25.3 will enforce this behaviour change. A possible replacement is to use the standardized |
看不懂是吧?让大模型翻译成人话如下:
这是 pip 发出的弃用警告(Deprecation Warning),说明 python-office
这个包正在被用旧的 setup.py bdist_wheel
构建方式安装,而这种方式将在 pip 25.3(预计 2025 年第四季度)中被彻底移除。
📌 具体解释:
- 你运行了
pip install python-office
(或类似命令),pip 发现这个包没有提供pyproject.toml
文件,于是退回到旧的构建方式。 - 旧方式会直接调用
python setup.py bdist_wheel
,这已经被标记为过时,未来的 pip 版本将不再支持。 - 你现在还能正常安装,但未来可能会失败。
✅ 解决方式(取决于你是谁):
如果你是用户(使用者):
你可以暂时忽略警告,或者强制使用新标准(PEP 517)来安装:
1 | pip install python-office --use-pep517 |
⚠️ 如果这样失败了,说明项目本身还不支持新标准,那就只能等作者修复。
建议你把这个警告报告给 python-office
项目的维护者,让他们添加 pyproject.toml
。
如果你是作者/维护者(开发者):
你需要在项目根目录添加一个 pyproject.toml
文件,内容如下:
1 | [build-system] |
然后确保你的项目结构支持 PEP 517 构建(大多数 setuptools 项目都没问题)。
✅ 总结一句话:
这不是你的错,是项目
python-office
还在用旧的打包方式。你可以暂时忽略,也可以向项目报告问题,或者等作者修复。
不得不说,Python技术迭代也太快了!但这次更新是一个好事,让Python项目越来越规范了,我们也更好用。
修复问题
综合上面的内容看下来,是一个
参考文档: