👉 项目官网：https://www.python-office.com/ 👈

👉 本开源项目的交流群 👈

atomgit star github star gitee star PyPI Downloads AI交流群

大家好，这里是程序员晚枫，正在all in AI编程实战。

最近在疯狂更新开源项目：python-office、poocr、potx-cloud、PyOfficeRobot等等。

也把我一直想改进的打包方式做了一个升级，今天给大家分享一下。

问题说明

这个问题来自打包，在打包发布的时候，老是在后台收到一个提示：

1
2
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 
build interface by setting the `--use-pep517` option, (possibly combined with `--no-build-isolation`), or adding a `pyproject.toml` file to the source tree of 'python-office'. Discussion can be found at https://github.com/pypa/pip/issues/6334

看不懂是吧？让大模型翻译成人话如下：

这是 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
2
3
[build-system]
requires = ["setuptools >= 42.0.0"]
build-backend = "setuptools.build_meta"

然后确保你的项目结构支持 PEP 517 构建（大多数 setuptools 项目都没问题）。

✅ 总结一句话：

这不是你的错，是项目 python-office 还在用旧的打包方式。你可以暂时忽略，也可以向项目报告问题，或者等作者修复。

不得不说，Python技术迭代也太快了！但这次更新是一个好事，让Python项目越来越规范了，我们也更好用。

修复问题

综合上面的内容看下来，是一个

image.png

参考文档：

扫一扫，领红包

美团红包

相关阅读

程序员晚枫专注AI编程培训，小白看完他和图灵社区合作的教程《30讲 · AI编程训练营》就能上手做AI项目。

🎓 AI 编程实战课程

想系统学习 AI 编程？程序员晚枫的 AI 编程实战课 帮你从零上手！