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

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

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