配置Python SDK

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

   从 Microsoft Store 在 Windows 上安装 Python

   如果您使用的是 Windows，则可以从 Microsoft Store 下载 Python 并将其安装为 Python 解释器。从 Microsoft Store 下载 Python 应用程序后，它就会出现在 Python 可执行文件列表中。

   请注意，从 Microsoft Store 安装添加的解释器存在一些限制。由于 Microsoft Store 应用程序的限制，Python 脚本可能没有对共享位置（例如TEMP注册表）的完全写入访问权限。

2. 导航至文件 | 项目结构或按。CtrlAltShift0S

3. 在“项目结构”对话框中，选择“平台设置”部分下的SDK，单击，然后从弹出菜单中选择“添加 Python SDK” 。

   

4. 在“添加 Python 解释器”对话框的左侧窗格中，选择“系统解释器”。

   

5. 在“解释器”下拉列表中，选择系统中已安装的 Python 解释器之一，或者单击并在打开的“选择 Python 解释器”对话框中选择所需的 Python 可执行文件。

   

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

   

   根据提示，考虑为您的项目使用虚拟环境。

6. 单击“确定”完成任务。

有关详细信息，请参阅配置系统解释器。

1. 导航至文件 | 项目结构或按。CtrlAltShift0S

2. 在“项目结构”对话框中，选择“平台设置”部分下的SDK，单击，然后从弹出菜单中选择“添加 Python SDK” 。

   

3. 在“添加 Python 解释器”对话框的左侧窗格中，选择Virtualenv Environment。

   

4. 以下操作取决于您是要创建新的虚拟环境还是使用现有的虚拟环境。

   新的虚拟环境

   • 在“位置”字段中指定新虚拟环境的位置，或单击并浏览文件系统中的所需位置。新虚拟环境的目录应该为空。

   • 从列表中选择基本解释器，或者单击并在文件系统中找到所需的 Python 可执行文件。

   • 如果您希望将计算机上全局 Python 中安装的所有包添加到您要创建的虚拟环境中，请选中“继承全局站点包”复选框。该复选框对应于virtualenv--system-site-packages工具的选项。

   • 如果您想在 IntelliJ IDEA 中创建 Python 解释器时重用此环境，请选中“对所有项目可用”复选框。

   现有虚拟环境

   • 从列表中选择所需的口译员。

   • 如果所需的解释器不在列表中，请单击，然后浏览查找所需的 Python 可执行文件（例如， macOS 上的venv /bin /python或Windows 上的venv \Scripts \python.exe）。

   所选的虚拟环境将重新用于当前项目。

5. 单击“确定”完成任务。

笔记

如果IntelliJ IDEA显示无效环境警告，则意味着在文件系统中找不到指定的Python二进制文件，或者Python版本不受支持。检查 Python 路径并安装新版本（如果需要）。

有关详细信息，请参阅配置虚拟环境。

1. 确保Anaconda或Miniconda已下载并安装在您的计算机上，并且您知道其可执行文件的路径。

   有关详细信息，请参阅安装说明。

2. 导航至文件 | 项目结构或按。CtrlAltShift0S

3. 在“项目结构”对话框中，选择“平台设置”部分下的SDK，单击，然后从弹出菜单中选择“添加 Python SDK” 。

   

4. 在“添加 Python 解释器”对话框的左侧窗格中，选择“Conda 环境”。

   

5. 以下操作取决于您是要创建新的 conda 环境还是使用现有环境。

   新的conda环境

   • 在“位置”字段中指定新 conda 环境的位置，或单击并浏览文件系统中的所需位置。新 conda 环境的目录应该为空。

   • 从列表中选择 Python 版本。

   • 通常，IntelliJ IDEA 会检测 conda 安装。

     否则，指定 conda 可执行文件的位置，或单击进行浏览。

   • 如果您想在 IntelliJ IDEA 中创建 Python 解释器时重用此环境，请选中“对所有项目可用”复选框。

   现有conda环境

   • 从列表中选择所需的环境。

   • 如果所需的解释器不在列表中，请单击，然后在之前配置的 conda 环境中浏览查找 Python 可执行文件。

   • 如有必要，请指定 conda 可执行文件的位置，或单击进行浏览。

   • 如果您想在 IntelliJ IDEA 中创建 Python 解释器时重用此环境，请选中“对所有项目可用”复选框。

   所选的 conda 环境将在当前项目中重用。

6. 单击“确定”完成任务。

有关更多信息，请参阅配置 conda 虚拟环境。

1. 导航至文件 | 项目结构或按。CtrlAltShift0S

2. 在“项目结构”对话框中，选择“平台设置”部分下的SDK，单击，然后从弹出菜单中选择“添加 Python SDK” 。

   

3. 在“添加 Python 解释器”对话框的左侧窗格中，选择Pipenv Environment。

   

4. 从列表中选择基本解释器，或者单击并在文件系统中找到所需的 Python 可执行文件。

5. 如果您的项目包含Pipfile ，您可以通过启用或禁用从 Pipfile 安装软件包复选框来选择是否要安装其中列出的软件包。默认情况下，该复选框处于启用状态。

6. 如果您已将基本二进制目录添加到PATH环境变量中，则无需设置任何其他选项：将自动检测 pipelinev 可执行文件的路径。

   如果未找到 Pipenv 可执行文件，请按照Pipenv 安装过程查找可执行文件路径，然后将其粘贴到Pipenv 可执行文件字段中。

7. 单击“确定”完成任务。

将 pipelinenv 虚拟环境设置为 Python 解释器后，将从Pipfile中定义的源添加所有可用的包。软件包是通过 pipelinev 而不是通过 pip 在软件包列表中安装、删除和更新的。

有关更多信息，请参阅配置 pipelinev 环境。

1. 导航至文件 | 项目结构或按。CtrlAltShift0S

2. 在“项目结构”对话框中，选择“平台设置”部分下的SDK，单击，然后从弹出菜单中选择“添加 Python SDK” 。

   

3. 在“添加 Python 解释器”对话框的左侧窗格中，选择Poetry Environment。

   

4. 以下操作取决于您是要创建新的 Poetry 环境还是使用现有环境。

   新诗环境

   • 选择诗歌环境。

   • 从列表中选择基本解释器，或者单击并在文件系统中找到所需的 Python 可执行文件。

   • 如果您的项目包含pyproject.toml ，您可以通过启用或禁用从 pyproject.toml 安装软件包复选框来选择是否要安装其中列出的软件包。默认情况下，该复选框处于启用状态。

   • 如果 IntelliJ IDEA 未检测到 Poetry 可执行文件，请在Poetry 可执行文件字段中指定以下路径，并替换jetbrains为您的用户名：

     苹果系统

     视窗

     Linux

     /Users/jetbrains/Library/Application Support/pypoetry/venv/bin/poetry

     C:\Users\jetbrains\AppData\Roaming\pypoetry\venv\Scripts\poetry.exe

     /home/jetbrains/.local/bin/poetry

   现有诗歌环境

   • 确保项目目录包含pyproject.toml文件。

   • 选择现有环境。然后展开口译员列表并选择所需的口译员。

   • 如果所需的解释器不在列表中，请单击，然后在之前配置的 Poetry 环境中浏览查找 Python 可执行文件。

   所选的 Poetry 环境将在当前项目中重复使用。

5. 单击“确定”完成任务。

有关更多信息，请参阅配置 Poetry 环境。

1. 单击屏幕左下角的 Windows 按钮并开始输入System Information。为了确保您的系统能够与 WSL 良好配合，请将您的 Windows 升级到最新的可用版本。

2. 按照WSL 安装指南中的说明安装适用于 Linux 的 Windows 子系统并初始化您的 Linux 发行版。

3. 如果您的 Linux 发行版没有附带 rsync，您需要安装它：

   Derby安

   拱

   sudo apt install rsync

   sudo pacman -S rsync

   笔记

   使用 WSL 2 时，请注意以下已知的 WSL 问题：

   • 向 WSL2 网络的 Windows 防火墙添加“允许”规则

   • stdin 对于 Python 进程显式关闭

   • 如果未为 WSL IP 打开防火墙，调试器将无法正常工作。

4. 导航至文件 | 项目结构或按。CtrlAltShift0S

5. 在“项目结构”对话框中，选择“平台设置”部分下的SDK，单击，然后从弹出菜单中选择“添加 Python SDK” 。

   

6. 在“添加 Python 解释器”对话框的左侧窗格中，选择WSL。

7. 选择具有所需 Python 解释器的 Linux 发行版。

8. 在Python 解释器路径字段中，指定 Python 可执行文件的路径。您可以接受默认值、输入不同的路径或单击浏览。

   

9. 单击“确定”。

   配置的远程解释器将添加到列表中。

1. 确保满足以下先决条件（在 IntelliJ IDEA 之外）：

   • 您的计算机上安装了受支持的Vagrant 提供程序之一。

   • Vagrant安装在您的计算机上，并创建了所有必要的基础设施。

   • 以下可执行文件的父文件夹已添加到系统PATH变量中：

     • vagrant.bat或Vagrant 安装中的vagrant 。这应该由安装程序自动完成。

     • Oracle VirtualBox 安装中的VBoxManage.exe或VBoxManage 。

   • 所需的虚拟框已创建。

2. 确保Vagrant插件已安装并启用。

3. 确保您已正确启动并启动 Vagrant。基本上，您需要打开终端窗口并执行以下命令：

   $ vagrant init ubuntu/trusty64

   和

   $ vagrant up

   有关更多信息，请参阅Vagrant 文档。

4. 导航至文件 | 项目结构或按。CtrlAltShift0S

5. 在“项目结构”对话框中，选择“平台设置”部分下的SDK，单击，然后从弹出菜单中选择“添加 Python SDK” 。

   

6. 在“添加 Python 解释器”对话框的左侧窗格中，选择Vagrant。

7. 在Python 解释器路径字段中，指定 Python 可执行文件的路径。您可以接受默认值、输入不同的路径或单击浏览。

   

8. 单击“确定”。

   配置的远程解释器将添加到列表中。

警告

配置 SSH 解释器时不能使用 Windows 计算机作为远程主机。

1. 确保远程主机上运行着 SSH 服务器，因为 IntelliJ IDEA 通过 ssh 会话运行远程解释器。

2. 导航至文件 | 项目结构或按。CtrlAltShift0S

3. 在“项目结构”对话框中，选择“平台设置”部分下的SDK，单击，然后从弹出菜单中选择“添加 Python SDK” 。

   

4. 选择新服务器配置，然后指定服务器信息（主机、端口和用户名）。

   

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

   

   如果需要，请单击查看所选部署配置的连接设置、映射和排除路径。单击“下一步”继续配置解释器。

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

   

   选择密码或密钥对（OpenSSH 或 PuTTY）并输入您的密码或密码。如果选择密钥对（OpenSSH 或 PuTTY） ，请指定：

   • 私钥：包含私钥的文件的位置

   • 密码：类似于密码，用于加密私钥。

   单击“下一步”继续。

6. 在下一个对话框窗口中，验证所需 Python 解释器的路径。您可以接受默认值，也可以指定不同的值。您必须配置本地项目和服务器之间的路径映射。为此，请单击“同步文件夹”字段旁边的，然后输入本地项目文件夹的路径和远程服务器上的文件夹的路径。

   

   您还可以选中该复选框以启用将本地更改自动上传到远程服务器的功能。

7. 单击“确定”。

   配置的远程解释器将添加到列表中。

1. 确保满足以下先决条件：

   • Docker 已安装，如Docker 文档中所述。

   • 您有稳定的互联网连接，以便 IntelliJ IDEA 可以下载并运行busybox:latest（最新版本的BusyBox Docker 官方镜像）。使用 Docker 成功配置解释器后，您就可以离线了。

   请注意，您无法将任何 Python 包安装到基于 Docker 的项目解释器中。

2. 导航至文件 | 项目结构或按。CtrlAltShift0S

3. 在“项目结构”对话框中，选择“平台设置”部分下的SDK，单击，然后从弹出菜单中选择“添加 Python SDK” 。

   

4. 在“添加 Python 解释器”对话框的左侧窗格中，选择Docker。

   

5. 在Docker 服务器下拉列表中选择现有的 Docker 配置。

   或者，单击“新建”并执行以下步骤来创建新的 Docker 配置：

   创建 Docker 配置

   单击以添加 Docker 配置并指定如何连接到 Docker 守护程序。

   连接设置取决于您的 Docker 版本和操作系统。有关更多信息，请参阅Docker 连接设置。

   连接成功消息应出现在对话框底部。

   

   有关在 Windows 或 macOS 上使用 Docker 时将本地路径映射到运行 Docker 守护程序的虚拟机的更多信息，请参阅Windows 和 macOS 主机的虚拟机路径映射。您将无法对映射的本地路径之外的目录使用卷和绑定安装。

   该表在 Linux 主机上不可用，Docker 在 Linux 主机上本机运行，您可以将任何目录挂载到容器中。

6. 指定图像和 Python 可执行文件的路径：

   

7. 单击“确定”。

   配置的远程解释器将添加到列表中。

1. 确保满足以下先决条件：

   • Docker 已安装，如Docker 文档中所述。

   • 您有稳定的互联网连接，以便 IntelliJ IDEA 可以下载并运行busybox:latest（最新版本的BusyBox Docker 官方镜像）。使用 Docker 成功配置解释器后，您就可以离线了。

   请注意，您无法将任何 Python 包安装到基于 Docker 的项目解释器中。

2. 导航至文件 | 项目结构或按。CtrlAltShift0S

3. 在“项目结构”对话框中，选择“平台设置”部分下的SDK，单击，然后从弹出菜单中选择“添加 Python SDK” 。

   

4. 在“添加 Python 解释器”对话框的左侧窗格中，选择Docker Compose。

   

5. 在服务器下拉列表中选择现有的 Docker 配置。

   或者，单击“新建”并执行以下步骤来创建新的 Docker 配置：

   创建 Docker 配置

   单击以添加 Docker 配置并指定如何连接到 Docker 守护程序。

   连接设置取决于您的 Docker 版本和操作系统。有关更多信息，请参阅Docker 连接设置。

   连接成功消息应出现在对话框底部。

   

   有关在 Windows 或 macOS 上使用 Docker 时将本地路径映射到运行 Docker 守护程序的虚拟机的更多信息，请参阅Windows 和 macOS 主机的虚拟机路径映射。您将无法对映射的本地路径之外的目录使用卷和绑定安装。

   该表在 Linux 主机上不可用，Docker 在 Linux 主机上本机运行，您可以将任何目录挂载到容器中。

6. 在配置文件中，指定docker-compose.yml文件。还要选择服务。

   

   （可选）指定环境变量并在项目名称中编辑Compose 项目名称。

7. 最后，指定 Python 可执行文件的路径：

   

8. 单击“确定”。

   配置的远程解释器将添加到列表中。