PyCharm 2026.2 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 解释器。

2026年 7月 14日