PyCharm 2025.3 Help

配置 virtualenv 环境

PyCharm 允许使用 virtualenv 工具创建特定于项目的隔离 虚拟环境。 虚拟环境的主要目的在于独立于其他 Python 项目,管理特定项目的设置和依赖项。 virtualenv 工具随 PyCharm 一起提供,因此您无需安装。

创建 virtualenv 环境

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

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

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

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

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

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

    新的 virtualenv 环境
    生成新的 virtualenv 环境
    1. 在环境类型列表中选择 Virtualenv

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

    3. 位置 字段中指定新虚拟环境的位置,或点击 虚拟环境位置 ,在您的文件系统中浏览并选择位置。 新虚拟环境所在目录应为空。

    4. 如果希望将您计算机上全局 Python 中安装的所有软件包添加到要创建的虚拟环境中,请选中 继承基础解释器的包 复选框。 此复选框对应 virtualenv 工具的 --system-site-packages 选项。

    5. 如果希望在 PyCharm 中创建 Python 解释器时复用此环境,请选中 对所有项目可用 复选框。

    现有 virtualenv 环境
    选择现有 virtualenv 环境
    • 在环境类型列表中选择 Python

    • 从列表中选择所需的解释器。

      如果所需解释器不在列表中,点击 ,然后浏览并选择所需的 Python 可执行文件(例如,macOS 上的 venv/bin/python 或 Windows 上的 venv\Scripts\python.exe )。

    所选虚拟环境将复用于当前项目。

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

您可以按需创建任意数量的虚拟环境。 为便于区分,请使用不同的名称。

PyCharm 可基于项目需求为您的项目创建虚拟环境。

使用项目需求创建虚拟环境

  1. 打开任意包含 requirements.txt setup.py 文件的源文件目录:在主菜单中选择 文件 | 打开 并选择该目录。

  2. 如果尚未为该项目创建虚拟环境,PyCharm 会建议创建。

    包含配置项目解释器选项的警告
  3. 点击 使用 requirements.txt 创建虚拟环境

    使用 requirements.txt 文件创建虚拟环境
  4. 保留建议的选项,或指定环境位置或基础 Python 解释器。 点击 确定 完成此任务。

点击 确定 后,PyCharm 将创建环境并安装所有必需的软件包。 完成后,将显示通知弹窗:

环境已创建

请注意,如果您忽略创建虚拟环境的建议,PyCharm 将不会为您的项目创建 Python 解释器。 因此,每当您打开 .py 文件时,都会看到包含配置项目解释器选项的警告:

当您希望升级环境所基于的 Python 版本(例如,从 3.5 升级到 3.9)时,此方法尤其有用。 您可以指定新的基础解释器,并使用 requirements.txt 以确保所有必需的软件包都已安装。

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

创建新的虚拟环境后,您可以将其复用于其他项目。 详细了解如何 设置现有环境 并将其用作 Python 解释器。

最后修改日期: 2025年 12月 2日