配置 Python SDK
要在 IntelliJ IDEA 中开发 Python 脚本,请下载并安装 Python 并配置至少一个 Python SDK。 可以将 Python SDK 指定为 Python 项目的 Python 解释器。
IntelliJ IDEA 支持:
要查看可用 SDK 列表,请从主菜单 Ctrl+Alt+Shift+S 中选择 。 Python SDK 可以在以下级别进行配置:
所选 SDK 可用于所有 Python 项目。

选定的 SDK 将用于当前项目及其所有模块。

所选 SDK 将用于当前项目模块。

若要轻松区分它们,请在 名称 字段中输入不同的名称。 有关 SDK 配置的更多信息,请参阅 SDK。
要添加 Python SDK,您必须配置 Python 解释器。 无论级别如何,您都可以配置本地或远程 Python 解释器。
配置本地 Python 解释器
要配置本地 Python 解释器,请遵循以下任一程序:
配置系统解释器
确保您已在计算机上下载并安装 Python。
- 从 Microsoft Store 安装 Python
如果您使用的是 Windows,您可以从 Microsoft Store 下载 Python 并将其安装为 Python 解释器。 一旦从 Microsoft Store 下载 Python 应用程序,它就会出现在 Python 可执行文件列表中。
请注意,从 Microsoft Store 安装的解释器有一些限制。 由于对 Microsoft Store 应用的限制,Python 脚本可能无法完全写入共享位置,如
TEMP和注册表。
请导航至 或按 Ctrl+Alt+Shift+S。
在 项目结构 对话框中,选择 SDK 下的 平台设置 部分,点击
,并从弹出菜单中选择 添加 Python SDK。

在 添加 Python 解释器 对话框的左侧窗格中,选择 系统解释器。

在 解释器 下拉菜单中,选择您系统中已安装的一个 Python 解释器,或点击
并在打开的 选择 Python 解释器 对话框中,选择所需的 Python 可执行文件。

您需要管理员权限来安装、删除和升级系统解释器的软件包。 尝试通过意图操作安装解释器包时,您可能会收到以下错误消息:

建议您为项目使用虚拟环境。
点击 OK 完成此任务。
有关更多信息,请参阅 PyCharm 文档。
创建 virtualenv 环境
请导航至 或按 Ctrl+Alt+Shift+S。
在 项目结构 对话框中,选择 SDK 下的 平台设置 部分,点击
,并从弹出菜单中选择 添加 Python SDK。

在 添加 Python 解释器 对话框的左侧窗格中,选择 Virtualenv Environment。

以下操作取决于您是要创建一个新的虚拟环境还是使用现有的虚拟环境。
- 新虚拟环境
从列表中选择基础解释器,或者点击
并在您的文件系统中找到 Python 可执行文件。
指定新虚拟环境的位置在 位置 字段中,或者点击
并在您的文件系统中浏览位置。 新虚拟环境的目录应该是空的。
如果您希望将机器上全局 Python 中安装的所有包添加到您将要创建的虚拟环境中,请选择 继承全局 site-packages 复选框。 此复选框对应
--system-site-packages选项的 virtualenv 工具。如果您希望在 IntelliJ IDEA 中创建 Python interpreters 时重用此环境,请选择 向所有项目开放 复选框。
- 现有虚拟环境
从列表中选择所需的解释器。
如果所需的解释器不在列表中,请点击
,然后浏览所需的 Python 可执行文件(例如,在 macOS 上 venv/bin/python 或在 Windows 上 venv\Scripts\python.exe )。
已选择的虚拟环境将为当前项目重复使用。
点击 OK 完成此任务。
有关更多信息,请参阅 PyCharm 文档。
创建 conda 环境
确保 Anaconda 或 Miniconda 已下载并安装在您的计算机上,并且您知道其可执行文件的路径。
如需更多信息,请参阅 安装说明。
请导航至 或按 Ctrl+Alt+Shift+S。
在 项目结构 对话框中,选择 SDK 下的 平台设置 部分,点击
,并从弹出菜单中选择 添加 Python SDK。

在 添加 Python 解释器 对话框的左侧窗格中,选择 Conda 环境。

/>
接下来的操作取决于您是要创建一个新的 conda 环境还是使用现有的环境。
- 新 conda 环境
从环境类型列表中选择 Conda。
在 位置 字段中指定新 Conda 环境的位置,或点击
并在文件系统中浏览位置。 新 conda 环境的目录应为空。
从列表中选择 Python 版本。
通常,IntelliJ IDEA 会检测到 conda 的安装。
否则,指定 conda 可执行文件的位置,或点击
进行浏览。
如果您希望在 IntelliJ IDEA 中创建 Python interpreters 时重用此环境,请选择 向所有项目开放 复选框。
- 现有 conda 环境
从列表中选择环境。
如果列表中没有所需的解释器,请点击
,然后在先前配置的 conda 环境中浏览所需的 Python 可执行文件。
如果需要,请指定 conda 可执行文件的位置,或点击
进行浏览。
如果您希望在 IntelliJ IDEA 中创建 Python interpreters 时重用此环境,请选择 向所有项目开放 复选框。
所选的 conda 环境将被重新用于当前项目。
点击 OK 完成此任务。
有关更多信息,请参阅 PyCharm 文档。
创建 pipenv 环境
请导航至 或按 Ctrl+Alt+Shift+S。
在 项目结构 对话框中,选择 SDK 下的 平台设置 部分,点击
,并从弹出菜单中选择 添加 Python SDK。

在 添加 Python 解释器 对话框的左侧窗格中,选择 Pipenv 环境。

从列表中选择基础解释器,或点击
并在您的文件系统中找到 Python 可执行文件。
如果您的项目包含 Pipfile ,您可以通过启用或禁用 从 Pipfile 安装软件包 复选框选择是否安装其中列出的包。 默认情况下,复选框是启用的。
如果您已将基础二进制目录添加到您的
PATH环境变量中,则无需设置任何其他选项:pipenv 可执行文件的路径将自动检测。如果未找到 pipenv 可执行文件,请按照 pipenv 安装程序 发现可执行文件路径,然后在对话框中指定它。
点击 OK 完成此任务。
当您将 pipenv 虚拟环境设置为 Python 解释器时,所有可用的软件包会从 Pipfile 中定义的源添加。 可以通过 pipenv 而不是 pip 在包列表中安装、移除和更新包。
有关更多信息,请参阅 PyCharm 文档。
创建一个 Poetry 环境
请导航至 或按 Ctrl+Alt+Shift+S。
在 项目结构 对话框中,选择 SDK 下的 平台设置 部分,点击
,并从弹出菜单中选择 添加 Python SDK。

在 添加 Python 解释器 对话框的左侧窗格中,选择 Poetry 环境。

以下操作取决于您是想创建一个新的 Poetry 环境还是使用一个现有的环境。
- 新的 Poetry 环境
选择 Poetry 环境。
从列表中选择基础解释器,或者点击
并在您的文件系统中找到 Python 可执行文件。
如果您的项目包含 pyproject.toml ,您可以通过启用或禁用 从 pyproject.toml 安装软件包 复选框选择是否安装其中列出的包。 默认情况下,复选框是启用的。
如果 IntelliJ IDEA 未检测到 poetry 可执行文件,请点击 通过 pip 安装 poetry 以允许 IntelliJ IDEA 自动为您安装 poetry。
如果 IntelliJ IDEA 未检测到 poetry 可执行文件,请在对话框中指定以下路径,将
jetbrains替换为您的用户名:/Users/jetbrains/Library/Application Support/pypoetry/venv/bin/poetryC:\Users\jetbrains\AppData\Roaming\pypoetry\venv\Scripts\poetry.exe/home/jetbrains/.local/bin/poetry
- 现有 Poetry 环境
确保项目目录包含一个 pyproject.toml 文件。
请选择 现有环境。 然后展开 解释器 列表并选择解释器。
如果列表中没有所需的解释器,请点击
,然后在先前配置的 Poetry 环境中浏览所需的 Python 可执行文件。
所选的 Poetry 环境将用于当前项目。
点击 OK 完成此任务。
有关更多信息,请参阅 PyCharm 文档。
配置远程 Python 解释器
要配置远程 Python 解释器:
配置 WSL 解释器
请点击屏幕左下角的 Windows 按钮并开始输入
System Information。 为了确保您的系统能够良好运行 WSL, 请将 Windows 升级到最新可用版本。按照 WSL 安装指南中所述,安装 Windows Subsystem for Linux 并初始化您的 Linux 发行版。
如果您的 Linux 发行版未提供 rsync,您需要安装它:
sudo apt install rsyncsudo pacman -S rsync请导航至 或按 Ctrl+Alt+Shift+S。
在 项目结构 对话框中,选择 SDK 下的 平台设置 部分,点击
,并从弹出菜单中选择 添加 Python SDK。

在 添加 Python 解释器 对话框的左侧窗格中,选择 WSL。
选择具有所需 Python 解释器的 Linux 发行版。
在 Python 解释器路径 字段中,指定 Python 可执行文件的路径。 您可以接受默认路径、输入不同的路径,或点击
进行浏览。

点击 OK。
已将配置的远程解释器添加到列表中。
使用 Vagrant 配置解释器
确保满足以下先决条件(在 IntelliJ IDEA 之外):
您的计算机上安装了其中一个支持的 Vagrant providers。
Vagrant 已安装在您的计算机上,所有必要的基础设施都已创建。
以下可执行文件的父文件夹已添加到系统
PATH变量中:vagrant.bat 或 vagrant 来自您的 Vagrant 安装。 这应该由安装程序自动完成。
或您的 Oracle 的 VirtualBox 安装中的 VBoxManage.exe 或 VBoxManage 。
已创建所需的虚拟机。
请确保已安装并启用 Vagrant 插件。
请确保您已正确初始化并启动 Vagrant。 您基本上需要打开 终端窗口 并执行以下命令:
$ vagrant init ubuntu/trusty64以及
$ vagrant up如需更多信息,请参阅 Vagrant 文档。
请导航至 或按 Ctrl+Alt+Shift+S。
在 项目结构 对话框中,选择 SDK 下的 平台设置 部分,点击
,并从弹出菜单中选择 添加 Python SDK。

在 添加 Python 解释器 对话框的左侧窗格中,选择 Vagrant。
在 Python 解释器路径 字段中,指定 Python 可执行文件的路径。 您可以接受默认路径、输入不同的路径,或点击
进行浏览。

点击 OK。
已将配置的远程解释器添加到列表中。
使用 SSH 配置解释器
请确保远程主机上运行着一个 SSH 服务器,因为 IntelliJ IDEA 通过 ssh-session 运行远程解释器。
请导航至 或按 Ctrl+Alt+Shift+S。
在 项目结构 对话框中,选择 SDK 下的 平台设置 部分,点击
,并从弹出菜单中选择 添加 Python SDK。

选择 新的服务器配置 ,然后指定服务器信息(主机、端口和用户名)。

或者,您可以选择 现有服务器配置 并从列表中选择任何可用的部署配置。

在下一个对话框窗口中,提供连接目标服务器的身份验证详细信息。

选择 密码 或 密钥对(OpenSSH 或 PuTTY) 并输入您的密码或密码短语。 如果 密钥对(OpenSSH 或 PuTTY) 被选中,请指定:
私钥 :包含私钥的文件位置
密码短语 :类似于密码,它用于 加密私钥。
点击 下一个 继续。
在下一个对话窗口中,验证所需 Python interpreter 的路径。 您可以接受默认值,也可以指定一个不同的值。 您必须配置本地项目和服务器之间的路径映射。 为此,点击
旁边的 同步文件夹 字段,并输入本地项目文件夹的路径和远程服务器上文件夹的路径。

您还可以选中“复选框”以启用本地更改自动上传到远程服务器。
点击 OK。
已将配置的远程解释器添加到列表中。
使用 Docker 配置解释器
请确保满足以下先决条件:
按照 Docker 文档中描述的内容,Docker 已安装。
您有稳定的互联网连接,因此IntelliJ IDEA可以下载并运行
busybox:latest(BusyBox Docker Official Image的最新版本)。 配置好使用 Docker 的解释器后,您就可以离线了。
请注意,您无法将任何 Python 包安装到基于 Docker 的项目解释器中。
请导航至 或按 Ctrl+Alt+Shift+S。
在 项目结构 对话框中,选择 SDK 下的 平台设置 部分,点击
,并从弹出菜单中选择 添加 Python SDK。

在 添加 Python 解释器 对话框的左侧窗格中,选择 Docker。

在 Docker 服务器 下拉菜单中选择一个现有的 Docker 配置。
或者,点击 新建 并执行以下步骤以创建新的 Docker 配置:
- 创建 Docker 配置
点击
以添加 Docker 配置,并指定如何连接到 Docker 守护进程。
连接设置取决于您的 Docker 版本和操作系统。 如需更多信息,请参阅 Docker connection settings。
连接成功 消息应出现在对话框的底部。

有关在 Windows 或 macOS 上使用 Docker 时将本地路径映射到运行 Docker 守护进程的虚拟机的更多信息,请参阅 Windows 和 macOS 主机的虚拟机路径映射。 您将无法对映射本地路径之外的目录使用卷和绑定挂载。
此表在 Linux 主机上不可用,在该主机上 Docker 本地运行,您可以将任何目录挂载到容器。
请指定图像和 Python 可执行文件的路径:

点击 OK。
已将配置的远程解释器添加到列表中。
使用 Docker Compose 配置解释器
请确保满足以下先决条件:
按照 Docker 文档中描述的内容,Docker 已安装。
您有稳定的互联网连接,因此IntelliJ IDEA可以下载并运行
busybox:latest(BusyBox Docker Official Image的最新版本)。 配置好使用 Docker 的解释器后,您就可以离线了。
请注意,您无法将任何 Python 包安装到基于 Docker 的项目解释器中。
请导航至 或按 Ctrl+Alt+Shift+S。
在 项目结构 对话框中,选择 SDK 下的 平台设置 部分,点击
,并从弹出菜单中选择 添加 Python SDK。

在 添加 Python 解释器 对话框的左侧窗格中,选择 Docker Compose。

在 服务器 下拉菜单中选择 Docker 配置。
请在 docker-compose.yml 文件中指定 配置文件 并选择服务。

可选地,指定 环境变量并编辑 Compose 项目名称。
最后,指定 Python 可执行文件的路径:

点击 OK。
已将配置的远程解释器添加到列表中。
有关远程 Python 解释器的更多信息,请参阅 PyCharm 文档。
移除 Python 解释器
如果您不再需要项目中的 Python 解释器,可以将其从项目设置中移除。
请导航至 或按 Ctrl+Alt+Shift+S。
在 项目结构 对话框中,点击 SDK 节点下的 平台设置。
请选择您要删除的解释器,然后点击
。

管理解释器路径
IntelliJ IDEA 使得可以将路径添加到所选解释器。 这些路径将会被添加到环境变量 PYTHONPATH。 IntelliJ IDEA 将为这些路径建立索引并解析代码中的对象(例如,导入包)。
查看解释器路径
请导航至 或按 Ctrl+Alt+Shift+S。
在 项目结构 对话框中,点击 SDK 节点下的 平台设置。
请选择解释器。
在 类路径 选项卡中查看解释器路径:

添加解释器路径
在 类路径 选项卡中,点击
。
在打开的对话框中指定路径。 请注意,若要为特定的 Python 版本添加路径,您需要从 https://www.python.org/ 下载并安装它到您的机器上。
删除解释器路径
选择要在 类路径 选项卡中删除的路径。
点击
。