配置 Python SDK

1. 请导航至 文件 | 项目结构 或按 Ctrl+Alt+Shift+S。

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

   

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

   新的 virtualenv 环境

   

   1. 从环境类型列表中选择 Virtualenv。

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

   3. 指定新虚拟环境的位置在 位置 字段中，或者点击 并在您的文件系统中浏览位置。 新虚拟环境的目录应该是空的。

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

   5. 如果您希望在 IntelliJ IDEA 中创建 Python 解释器时复用此环境，请勾选 向所有项目开放 复选框。

   现有的 virtualenv 环境

   

   • 从环境类型列表中选择 Virtualenv。

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

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

   已选择的虚拟环境将为当前项目重复使用。

4. 点击 OK 完成此任务。

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

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

   如需更多信息，请参阅 安装说明。

2. 请导航至 文件 | 项目结构 或按 Ctrl+Alt+Shift+S。

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

   

4. 接下来的操作取决于您是要创建一个新的 conda 环境还是使用现有的环境。

   新 conda 环境

   

   1. 从环境类型列表中选择 Conda。

   2. 从列表中选择 Python 版本。

   3. 指定环境名称。

   4. 通常，IntelliJ IDEA 会检测到 conda 的安装。

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

   现有 conda 环境

   

   1. 从环境类型列表中选择 Conda。

   2. 通常，IntelliJ IDEA 会检测到 conda 的安装。

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

   3. 从列表中选择环境。

   所选的 conda 环境将被重新用于当前项目。

5. 点击 OK 完成此任务。

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

1. 请导航至 文件 | 项目结构 或按 Ctrl+Alt+Shift+S。

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

   

3. 从环境类型列表中选择 Pipenv。

   

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

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

   如果 IntelliJ IDEA 未检测到 pipenv 可执行文件，请点击 通过 pip 安装 pipenv 以允许 IntelliJ IDEA 自动为您安装。

   或者，按照 pipenv 安装过程 发现可执行文件路径，然后在对话框中指定它。

6. 点击 OK 完成此任务。

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

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

1. 请导航至 文件 | 项目结构 或按 Ctrl+Alt+Shift+S。

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

   

3. 以下操作取决于您是想创建一个新的 Poetry 环境还是使用一个现有的环境。

   新的 Poetry 环境

   

   1. 从环境类型列表中选择 Poetry。

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

   3. 如果 IntelliJ IDEA 未检测到 poetry 可执行文件，请点击 通过 pip 安装 poetry 以允许 IntelliJ IDEA 自动为您安装 poetry。

      或者，点击 选择路径 并手动选择所需的文件，或在对话框中指定以下路径，将 jetbrains 替换为您的用户名：

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

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

      /home/jetbrains/.local/bin/poetry

   4. 要在项目目录中创建虚拟环境，请勾选 创建项目内环境 复选框。

   现有 Poetry 环境

   

   1. 确保项目目录包含一个 pyproject.toml 文件。

   2. 从列表中选择解释器。

      如果列表中没有所需的解释器，请点击 ，然后在先前配置的 Poetry 环境中浏览所需的 Python 可执行文件。

   3. 从列表中选择环境。

   所选的 Poetry 环境将用于当前项目。

4. 点击 OK 完成此任务。

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

1. 请导航至 文件 | 项目结构 或按 Ctrl+Alt+Shift+S。

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

   

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

   新的 uv 环境

   

   1. 从环境类型列表中选择 uv。

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

   3. 通常，IntelliJ IDEA 会检测到 uv 安装。

      否则，请指定 uv 可执行文件的位置，或点击 以浏览选择。

   现有 uv 环境

   

   1. 从环境类型列表中选择 uv。

   2. 通常，IntelliJ IDEA 会检测到 uv 安装。

      否则，请指定 uv 可执行文件的位置，或点击 以浏览选择。

   3. 从列表中选择环境。

   所选的 uv 环境将用于当前项目。

4. 点击 OK 完成此任务。

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

1. 请导航至 文件 | 项目结构 或按 Ctrl+Alt+Shift+S。

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

   

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

   新的 Hatch 环境

   

   1. 从环境类型列表中选择 Hatch。

   2. 通常，IntelliJ IDEA 会检测到 Hatch 安装。

      否则，请指定 Hatch 可执行文件的位置，或点击 以浏览选择。

   3. 选择一个环境。

      Hatch 环境是为各种特定项目任务设计的工作区。 如果未明确选择环境，Hatch 将使用 默认环境。

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

   现有 Hatch 环境

   

   1. 从环境类型列表中选择 Hatch。

   2. 通常，IntelliJ IDEA 会检测到 Hatch 安装。

      否则，请指定 Hatch 可执行文件的位置，或点击 以浏览选择。

   3. 从列表中选择环境。

4. 点击 OK 完成此任务。

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

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

2. 按照 WSL 安装指南中所述，安装 Windows Subsystem for Linux 并初始化您的 Linux 发行版。

3. 如果您的 Linux 发行版未提供 rsync，您需要安装它：

   sudo apt install rsync

   sudo pacman -S rsync

4. 请导航至 文件 | 项目结构 或按 Ctrl+Alt+Shift+S。

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

   

6. 从环境类型列表中选择 WSL。

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

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

   

9. 点击 OK。

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

1. 请确保远程主机上运行着一个 SSH 服务器，因为 IntelliJ IDEA 通过 ssh-session 运行远程解释器。

2. 请导航至 文件 | 项目结构 或按 Ctrl+Alt+Shift+S。

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

   

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

   

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

   

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

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

   

   选择 密码 或 密钥对(OpenSSH 或 PuTTY) 并输入您的密码或密码短语。 如果 密钥对(OpenSSH 或 PuTTY) 被选中，请指定：

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

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

   点击 下一个 继续。

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

   

   您还可以选中“复选框”以启用本地更改自动上传到远程服务器。

7. 点击 OK。

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

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

   • 按照 Docker 文档中描述的内容，Docker 已安装。

   • 您有稳定的互联网连接，因此IntelliJ IDEA可以下载并运行 busybox:latest （BusyBox Docker Official Image的最新版本）。 配置好使用 Docker 的解释器后，您就可以离线了。

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

2. 请导航至 文件 | 项目结构 或按 Ctrl+Alt+Shift+S。

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

   

4. 从环境类型列表中选择 Docker。

   

5. 在 Docker 服务器 下拉菜单中选择一个现有的 Docker 配置。

   或者，点击 新建 并执行以下步骤以创建新的 Docker 配置：

   创建 Docker 配置

   点击 以添加 Docker 配置，并指定如何连接到 Docker 守护进程。

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

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

   

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

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

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

   

7. 点击 OK。

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

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

   • 按照 Docker 文档中描述的内容，Docker 已安装。

   • 您有稳定的互联网连接，因此IntelliJ IDEA可以下载并运行 busybox:latest （BusyBox Docker Official Image的最新版本）。 配置好使用 Docker 的解释器后，您就可以离线了。

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

2. 请导航至 文件 | 项目结构 或按 Ctrl+Alt+Shift+S。

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

   

4. 从环境类型列表中选择 Docker Compose。

   

5. 在 服务器 下拉菜单中选择 Docker 配置。

6. 请在 docker-compose.yml 文件中指定 配置文件 并选择服务。

   

   可选地，指定 环境变量并编辑 Compose 项目名称。

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

   

8. 点击 OK。

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