配置 uv 环境
uv 工具使 Python 开发更为便捷,减少新项目的设置工作,并帮助管理现有项目。
要在 PyCharm 中使用 uv ,您需要 在您的计算机上安装它 ,并创建一个专用的 Python 环境。
在 创建新的 Python 项目时选择 uv ,PyCharm 会自动生成一个 pyproject.toml 文件。 该文件指定所需的软件包、脚本、插件和 URL。 请参阅 pyproject 指南以了解其结构和格式的更多信息。
创建 uv 环境
请执行以下任一操作:
点击 Python 解释器选择器 ,然后选择 添加新解释器。
按下 Ctrl+Alt+S 打开 设置 ,并转到 。
点击 Python 解释器选择器 ,然后选择 解释器设置。 点击可用解释器列表旁的 添加解释器 链接。
点击可用解释器列表旁的 添加解释器 链接,并选择 添加本地解释器。
接下来的操作取决于您是要生成新的虚拟环境还是使用现有环境。
- 新建 uv 环境

在环境类型列表中选择 uv。
从列表中选择 Python 版本。
PyCharm 将检测到 uv 安装。
如果 PyCharm 未自动检测到该安装,请指定 uv 可执行文件的位置,或点击
进行浏览。
- 现有 uv 环境

在环境类型列表中选择 uv。
PyCharm 将检测到 uv 安装。
如果 PyCharm 未自动检测到该安装,请指定 uv 可执行文件的位置,或点击
进行浏览。
从列表中选择该环境。
所选 uv 环境将被复用于当前项目。
点击 确定 以完成该任务。
配置好 uv 环境后,您可以使用终端或 uv 运行/调试配置 来运行您的项目。
对于任何已配置的 Python 解释器(但基于 Docker 的除外),您可以:
最后修改日期: 2025年 12月 2日