PyCharm Beta 版本支持 uv、Poetry 和 Hatch 工作区

支持 uv、Poetry 和 Hatch 工作区（Beta）| PyCharm 博客

[](https://blog.jetbrains.com/pycharm/2026/05/support-for-uv-poetry-and-hatch-workspaces-beta/#)

Cookie 设置

我们的网站使用了一些 cookie，并记录了您的 IP 地址，以实现无障碍访问、安全性和管理对电信网络的访问。您可以更改浏览器设置来禁用数据收集和 cookie，但这可能会影响此网站的功能。了解更多

在您的同意下，JetBrains 可能还会使用 cookie 和您的 IP 地址来收集个人统计数据，并向您提供个性化的产品和服务，包括广告，这受隐私声明和使用条款的约束。JetBrains 可能会使用第三方服务来实现这一目的。您可以在任何时候通过访问退出选择页面调整或撤回您的同意。

接受全部 管理设置

[](https://blog.jetbrains.com/)跳至内容

• 主题
• _搜索_

汉堡菜单图标

• #### 软件开发环境

• [CLion](https://blog.jetbrains.com/clion/ "CLion 博客")
• [DataGrip](https://blog.jetbrains.com/datagrip/ "DataGrip 博客")
• DataSpell
• [GoLand](https://blog.jetbrains.com/go/ "GoLand 博客")
• [IntelliJ IDEA](https://blog.jetbrains.com/idea/ "IntelliJ IDEA 博客")
• [PhpStorm](https://blog.jetbrains.com/phpstorm/ "PhpStorm 博客")
• [PyCharm](https://blog.jetbrains.com/pycharm/ "PyCharm 博客")
• RustRover
• [Rider](https://blog.jetbrains.com/dotnet/tag/rider/ "Rider 博客")
• [RubyMine](https://blog.jetbrains.com/ruby/ "RubyMine 博客")
• [WebStorm](https://blog.jetbrains.com/webstorm/ "WebStorm 博客")

• #### 插件与服务

• 大数据工具
• [JetBrains 平台](https://blog.jetbrains.com/platform/ "JetBrains 平台博客")
• Scala
• [Toolbox 应用程序](https://blog.jetbrains.com/toolbox-app/ "Toolbox 应用程序博客")
• JetBrains AI
• Grazie
• Junie
• JetBrains 大数据解决方案
• Air

• #### 团队工具

• Datalore
• [TeamCity](https://blog.jetbrains.com/teamcity/ "TeamCity 博客")
• [YouTrack](https://blog.jetbrains.com/youtrack/ "YouTrack 博客")
• Qodana
• CodeCanvas
• Matter
• Databao

• #### .NET 和 Visual Studio

• [.NET 工具](https://blog.jetbrains.com/dotnet/ ".NET 工具")
• [ReSharper C++](https://blog.jetbrains.com/rscpp/ "ReSharper C++ 博客")

• #### 语言与框架

• [Kotlin](https://blog.jetbrains.com/kotlin/ "Kotlin 博客")
• Ktor
• [MPS](https://blog.jetbrains.com/mps/ "MPS 博客")
• Amper

• #### 教育与研究

• JetBrains 学院
• 研究

• #### 公司

• [JetBrains 公司博客](https://blog.jetbrains.com/blog/ "JetBrains 公司博客")
• 安全
• 社区计划
• 在 JetBrains 工作

## PyCharm 您唯一需要的 Python 集成开发环境。

关注

• 关注：
• _X_ X
• _YouTube_ YouTube
• _RSS_ RSS

支持 uv、Poetry 和 Hatch 工作区（Beta）

安东妮娜·贝利亚斯卡娅

2026年5月13日

工作区越来越成为公司和开源团队管理共享代码、确保一致性并简化跨多个服务的依赖管理的首选方案。在庞大的代码库中工作往往意味着同时处理许多相互依赖的 Python 项目。

为了简化这一体验，PyCharm 2026.1.1 引入了对 uv 工作区以及由 Poetry 和 Hatch 管理的工作区的支持。这项新功能目前处于 Beta 版本，允许 IDE 自动管理整个工作区中的依赖关系和环境。

智能工作区检测

当你打开一个工作区时，PyCharm 现在可以直接从你的 pyproject.toml 文件中推导出其完整的结构和所有依赖项。这使得 IDE 能够深入理解各个项目的相互关系，大大减少了你需要手动配置的内容。

由于这是 PyCharm 处理工作区方式的根本性改变，我们将其实现为一项可选功能。以下是关于过渡的信息：

• 启用对话框：当你打开一个项目时，PyCharm 可能会建议你启用自动检测 uv 工作区和 Poetry/Hatch 设置的功能。

• 手动配置：你可以在 _设置 | 项目结构_ 中切换工作区检测功能。

• 配置注意事项：如果你之前手动编辑了 .idea 文件中的设置，在同意新的模型后，这些设置可能会被重置。

管理工作区及其项目

PyCharm 现在提供了一种集成体验，可以自动处理 uv 工作区中的多包设置复杂性。当你打开一个 uv 工作区时，IDE 会识别各个项目及其相互依赖关系，确保项目结构准备好供你使用。

查看工作区依赖关系

加载工作区后，你可以验证各个项目之间的关系。PyCharm 在 _设置 | 项目依赖关系_ 中呈现这些依赖关系。

这些关系直接源自你的配置，并且在 UI 中以只读形式显示。要更改依赖关系图，你可以手动编辑 pyproject.toml 文件——PyCharm 将更新其内部模型。

自动环境配置

PyCharm 优先采用零配置的方法来处理你的 Python SDK。当你在一个项目中打开一个 .py 或 pyproject.toml 文件时，IDE 会立即进行检查。

如果系统中已经存在兼容的环境，PyCharm 会自动将其配置为该项目的 SDK。如果没有检测到环境，IDE 会在文件级别显示一个通知，建议你创建一个新的 uv 环境并安装该项目所需的依赖项。

维护环境一致性

除了初始设置外，PyCharm 还会持续监控环境的健康状况，确保它与你定义的要求保持同步。

如果某个依赖项未在 pyproject.toml 文件中定义但在代码中导入，PyCharm 将触发一个警告，并提供一个快速修复选项 _同步项目_ 来解决这些差异。

导入管理

当你正在积极编写代码时，PyCharm 还可以帮助你识别项目配置中的空白。如果导入了一个不在环境中存在的包，并且该包尚未在项目的 pyproject.toml 文件中列出，IDE 会检测到这个遗漏。快速修复选项会建议同时将该包添加到环境中并更新相应的 .toml 文件。

通过 _Python 进程输出_ 工具窗口实现透明度

虽然 PyCharm 自动化了命令的后台执行（例如 uv sync -all-packages），但它仍然保持完全透明。

你可以在 _Python 进程输出_ 工具窗口中跟踪所有已执行的命令及其实时输出。如果环境同步失败，你可以分析特定的错误日志以迅速找到根本原因。

Poetry 和 Hatch 工作区

对于 Poetry 和 Hatch 工作区，逻辑完全相同。PyCharm 通过 pyproject.toml 文件检测项目，并使用相同的自动化精度管理环境。

唯一的细微差别在于工具选择——建议的环境工具由你在 pyproject.toml 中指定的内容决定。如果没有指定工具，PyCharm 会优先选择 uv（如果已安装）或标准虚拟环境，以便快速启动。

展望未来

这项功能的 Beta 版本只是我们支持复杂工作区结构的重点的开始。我们已经开始扩展 UI，以允许创建新项目、链接依赖项以及为特定项目激活终端。

随着我们进一步完善这些功能，请分享你的想法或在我们的 YouTrack 问题跟踪器 上报告任何问题。

uv工作区

• 分享
• _Facebook_
• Twitter
• _LinkedIn_

_上一篇_ Python Unplugged on PyTV: 社区大会的关键收获

_下载 PyCharm_