配置 Python 解释器

PyCharm 使使用virtualenv工具创建特定于项目的隔离虚拟环境成为可能。虚拟环境的主要目的是管理特定项目的设置和依赖关系,而不考虑其他 Python 项目。virtualenv工具与 PyCharm 捆绑在一起,因此用户不需要安装它。

创建虚拟环境

  1. 确保您已在计算机上下载并安装Python

  2. 执行以下操作之一:

    • 单击Python 解释器选择器并选择添加解释器

    • Ctrl+Alt+S打开项目设置/首选项并转到项目 <项目名称> | Python 解释器。然后单击配置项目解释器图标并选择添加

      选择 Add 命令以创建新的 Python 解释器
  3. 在Add Python Interpreter对话框的左侧窗格中,选择Virtualenv Environment。以下操作取决于之前是否存在虚拟环境。

    创建虚拟环境

    如果选择了新环境

    1. 在文本字段中指定新虚拟环境的位置,或单击虚拟环境位置并在文件系统中查找位置。注意新的虚拟环境应该所在的目录,必须是空的!

    2. 从列表中选择基本解释器,或单击选择基本解释器并在文件系统中查找 Python 可执行文件。

      如果 PyCharm 检测到您的机器上没有 Python,它会提供两个选项:从python.org下载最新的 Python 版本或指定 Python 可执行文件的路径(在非标准安装的情况下)。

      创建虚拟环境时下载 Python

    3. 如果您希望将安装在您机器上的全局 Python 中的所有包都添加到您要创建的虚拟环境中,请选中继承全局站点包复选框。此复选框对应于virtualenv工具的--system-site-packages选项。

    4. 如果您想在 PyCharm 中创建 Python 解释器时重用此环境,请选中Make available to all projects复选框。

    如果选择现有环境

    1. 展开解释器列表并选择任何现有解释器。或者,单击选择口译员并指定文件系统中 Python 可执行文件的路径,例如C:\Python36\python.exe

    2. 如果您想在 PyCharm 中创建 Python 解释器时重用此环境,请选中Make available to all projects复选框。

  4. 单击确定以完成任务。

您可以根据需要创建任意数量的虚拟环境。为了方便地相互区分,请使用不同的名称。

设置现有的虚拟环境

  1. Ctrl+Alt+S打开 IDE 设置并选择Project <project name> | Python 解释器

  2. 展开可用解释器的列表并单击Show All链接。或者,单击该配置项目解释器图标并选择Show All

    显示所有可用的口译员

    虚拟环境标有虚拟环境

  3. 从列表中选择目标环境,然后单击确定以确认您的选择。

    选择虚拟环境

PyCharm 可以根据项目需求为您的项目创建虚拟环境。

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

  1. 使用包含requirements.txtsetup.py文件的源文件打开任何目录:选择File | 从主菜单打开并选择目录。

  2. 如果没有为此项目创建虚拟环境,PyCharm 建议创建它:

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

单击OK后,PyCharm 会创建一个环境并安装所有必需的包。完成后,请参阅弹出通知:

环境已创建

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

带有用于配置项目解释器的选项的警告

当您想要升级您的环境所基于的 Python 版本时,这种方法特别有用,例如,从 3.5 升级到 3.9。您可以指定一个新的基本解释器并使用requirements.txt来确保安装了所有需要的包。

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

一旦你创建了一个新的虚拟环境,你就可以将它重用于你的其他项目。了解更多如何将现有环境设置为 Python 解释器。

最后修改时间:2021 年 10 月 4 日