iyuluo

Python 新一代 Monorepo 工程组织方式

---

一、前言

最近打开 PyCharm，你可能会看到这样一个提示：

Enable and try workspace mode Beta

A large project can be split into smaller parts
(like backend, API, and shared code),
making it easier to organize and maintain.

很多人第一反应：

“这是啥？”

“和普通 Project 有什么区别？”

“是不是类似 pnpm workspace？”

“Python 终于开始搞 monorepo 了吗？”

实际上：

这个功能背后，代表的是 Python 工程组织方式的一次重大升级。

而它真正对应的生态，其实是：

uv + pyproject.toml + workspace

这篇文章会从：

• 为什么需要 Workspace
• 什么是 Monorepo
• uv Workspace 怎么用
• PyCharm Workspace Mode 如何配合
• 实际部署怎么做
• 如何避免架构混乱

完整讲清楚。