PyCharm 2026.1 Help

配置 uv 环境

uv 工具使 Python 开发更为便捷,减少新项目的设置工作,并帮助管理现有项目。

要在 PyCharm 中使用 uv ,您需要 在您的计算机上安装它 ,并创建一个专用的 Python 环境。

创建新的 Python 项目时选择 uv ,PyCharm 会自动生成一个 pyproject.toml 文件。 该文件指定所需的包、脚本、插件和 URL。 请参阅 pyproject 指南,了解其结构和格式。

创建 uv 环境

  1. 请执行下列任一操作:

    • 点击 Python 解释器选择器 ,然后选择 添加新解释器

    • Ctrl+Alt+S 打开 设置 ,并导航到 Python | 解释器

    • 点击 Python 解释器选择器 ,然后选择 解释器设置。 单击可用解释器列表旁边的 添加解释器 链接。

  2. 点击可用解释器列表旁边的 添加解释器 链接,并选择 添加本地解释器

  3. 接下来的操作取决于您是要生成新的虚拟环境还是使用现有环境。

    新建 uv 环境
    生成新的 uv 环境
    1. 从环境类型列表中选择 uv

    2. 从列表中选择 Python 版本。

    3. PyCharm 将检测到 uv 安装。

      如果 PyCharm 未自动检测到安装,请指定 uv 可执行文件的位置,或点击 浏览… 进行浏览。

    现有 uv 环境
    选择现有的 uv 环境
    1. 从环境类型列表中选择 uv

    2. PyCharm 将检测到 uv 安装。

      如果 PyCharm 未自动检测到安装,请指定 uv 可执行文件的位置,或点击 浏览… 进行浏览。

    3. 从列表中选择该环境。

    所选 uv 环境将被复用于当前项目。

  4. 点击 确定 完成该任务。

配置好 uv 环境后,您可以使用终端或 uv 运行/调试配置 来运行您的项目。

对于已配置的任何 Python 解释器(基于 Docker 的除外),您可以:

2026年 3月 24日