PyCharm 2025.1 Help

配置 uv 环境

uv 工具使 Python 开发更简单,减少新项目的设置任务并帮助管理现有项目。

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

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

创建 uv 环境

  1. 请执行以下操作之一:

    • 点击 Python Interpreter 选择器 并选择 添加新的解释器

    • Ctrl+Alt+S 以打开 设置 并转到 项目:<项目名称> | Python 解释器。 点击可用解释器列表旁的 添加解释器 链接。

    • 点击 Python Interpreter 选择器 并选择 解释器设置。 点击可用解释器列表旁的 添加解释器 链接。

  2. 请选择 添加本地解释器

  3. 以下操作取决于您是想生成一个新的虚拟环境还是使用现有的环境。

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

    2. 从列表中选择基础解释器,或者点击 选择基础解释器 并在您的文件系统中找到 Python 可执行文件。

    3. 通常,PyCharm 会检测到 uv 的安装。

      否则,请指定 uv 可执行文件的位置,或点击 uv 可执行文件位置 浏览以找到它。

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

    2. 通常,PyCharm 会检测到 uv 的安装。

      否则,请指定 uv 可执行文件的位置,或点击 Conda 可执行文件位置 浏览以找到它。

    3. 从列表中选择环境。

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

  4. 点击 OK 完成任务。

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

最后修改日期: 2025年 4月 23日