# 配置 Python SDK > For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt). > **Note:** > 请确保 [Python 插件](https://plugins.jetbrains.com/plugin/631-python)已 [安装并启用](managing-plugins.html)。 该插件实现了面向 Python 开发者的独立 IDE [PyCharm](https://www.jetbrains.com/zh-cn/pycharm/) 的全部功能。 有关受支持功能的详细信息，请参阅 [PyCharm 文档](https://www.jetbrains.com/zh-cn/help/pycharm/)。 要在 IntelliJ IDEA 中开发 Python 脚本，请下载并安装 [Python](http://www.python.org/) 并配置至少一个 Python SDK。 可以将 Python SDK 指定为 [Python 项目](creating-empty-python-project.html)的 Python 解释器。 IntelliJ IDEA 支持： * 标准 [Python interpreters](http://python.org/) * [PyPy](http://pypy.org/) 要查看可用 SDK 列表，请从主菜单 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))中选择 `文件 | 项目结构` 。 Python SDK 可以在以下级别进行配置： 平台级别: 所选 SDK 可用于所有 Python 项目。 ![显示可用的 Python SDK](https://resources.jetbrains.com/help/img/idea/2026.3/ij_sdk_packages.png) 项目级别: 选定的 SDK 将用于当前项目及其所有模块。 ![更改 Python SDK](https://resources.jetbrains.com/help/img/idea/2026.3/python_plugin_change_sdk.png) 模块级别: 所选 SDK 将用于当前项目模块。 ![管理 Python SDK 模块](https://resources.jetbrains.com/help/img/idea/2026.3/python_plugin_sdk_module.png) 若要轻松区分它们，请在 名称 字段中输入不同的名称。 有关 SDK 配置的更多信息，请参阅 [SDK](sdk.html)。 要添加 Python SDK，您必须配置 Python 解释器。 无论级别如何，您都可以配置本地或远程 Python 解释器。 ## 配置本地 Python 解释器 要配置本地 Python 解释器，请遵循以下任一程序： Procedure: 创建 virtualenv 环境 1. 转到 `文件 | 项目结构` ，或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。 2. 在 项目结构 对话框中，选择 平台设置 部分下的 SDK ，点击 ![添加新的 SDK](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后从弹出菜单中选择 从磁盘添加 Python SDK... 。 将打开 添加 Python 解释器 对话框。 ![添加新 Python SDK](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png) 3. 以下操作取决于要生成新的虚拟环境，还是使用现有虚拟环境。 新的 virtualenv 环境 : ![生成新的 virtualenv 环境](https://resources.jetbrains.com/help/img/idea/2026.3/ij_new_virtualenv_environment.png) : : 1. 从环境类型列表中选择 Virtualenv 。 : : 2. : : 从列表中选择基础解释器，或者点击 ![选择基础解释器](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中找到 Python 可执行文件。 : : : : 3. 在 位置 字段中指定新虚拟环境的位置，或者点击 ![虚拟环境位置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中浏览该位置。 新虚拟环境的目录应为空。 : : 4. : : 如果希望将计算机上全局 Python 中安装的所有软件包添加到将要创建的虚拟环境中，请选择 从基础解释器继承软件包 复选框。 此复选框对应 `--system-site-packages` 选项的 [virtualenv](http://www.virtualenv.org/en/latest/index.html) 工具。 现有 virtualenv 环境 : ![选择现有 virtualenv 环境](https://resources.jetbrains.com/help/img/idea/2026.3/ij_existing_virtualenv_environment.png) : : * 从环境类型列表中选择 Python 。 : : * 从列表中选择所需的解释器。 如果列表中没有所需的解释器，请点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)，然后浏览所需的 Python 可执行文件（例如，macOS 上的 `venv/bin/python` 或 Windows 上的 `venv\Scripts\python.exe` ）。 : : : : 已选择的虚拟环境将为当前项目重复使用。 4. 点击 OK 完成该任务。 > **Note:** > 如果 IntelliJ IDEA 显示 无效环境 警告，表示指定的 Python 二进制文件在文件系统中找不到，或 Python 版本 [不受支持](python.html#support)。 请检查 Python 路径，并在需要时 [安装新版本](https://www.python.org/downloads/)。 有关详细信息，请参阅 [PyCharm 文档](https://www.jetbrains.com/zh-cn/help/pycharm/creating-virtual-environment.html)。 Procedure: 创建 conda 环境 1. 确保 [Anaconda](https://www.continuum.io/) 或 [Miniconda](https://conda.io/en/latest/miniconda.html) 已下载并安装在您的计算机上，并且您知道其可执行文件的路径。 如需更多信息，请参阅 [安装说明](https://docs.anaconda.com/anaconda/install/)。 2. 转到 `文件 | 项目结构` ，或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。 3. 在 项目结构 对话框中，选择 平台设置 部分下的 SDK ，点击 ![添加新的 SDK](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后从弹出菜单中选择 从磁盘添加 Python SDK... 。 将打开 添加 Python 解释器 对话框。 ![添加新 Python SDK](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png) 4. 接下来的操作取决于您是要创建一个新的 conda 环境还是使用现有的环境。 新 conda 环境 : ![生成新的 conda 环境](https://resources.jetbrains.com/help/img/idea/2026.3/ij_new_conda_environment.png) : : 1. 从环境类型列表中选择 Conda 。 : : 2. 从列表中选择 Python 版本。 : : 3. 指定环境名称。 : : 4. : : IntelliJ IDEA 将检测到 conda 安装。 : : : : 如果 IntelliJ IDEA 未自动检测到该安装，请指定 conda 可执行文件的位置，或点击 ![Conda 可执行文件位置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 进行浏览。 现有 conda 环境 : ![选择现有 conda 环境](https://resources.jetbrains.com/help/img/idea/2026.3/ij_existing_conda_environment.png) : : 1. 从环境类型列表中选择 Conda 。 : : 2. : : IntelliJ IDEA 将检测到 conda 安装。 : : : : 如果 IntelliJ IDEA 未自动检测到该安装，请指定 conda 可执行文件的位置，或点击 ![浏览…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 进行浏览。 : : : : 3. 从列表中选择环境。 : : : : 所选的 conda 环境将被重新用于当前项目。 5. 点击 OK 完成该任务。 有关详细信息，请参阅 [PyCharm 文档](https://www.jetbrains.com/zh-cn/help/pycharm/conda-support-creating-conda-virtual-environment.html)。 Procedure: 创建 pipenv 环境 1. 转到 `文件 | 项目结构` ，或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。 2. 在 项目结构 对话框中，选择 平台设置 部分下的 SDK ，点击 ![添加新的 SDK](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后从弹出菜单中选择 从磁盘添加 Python SDK... 。 将打开 添加 Python 解释器 对话框。 ![添加新 Python SDK](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png) 3. 从环境类型列表中选择 Pipenv 。 ![生成新的 pipenv 环境](https://resources.jetbrains.com/help/img/idea/2026.3/ij_new_pipenv_environment.png) 4. 从列表中选择基础解释器，或者点击 ![浏览…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中找到 Python 可执行文件。 5. 如果您已将基础二进制目录添加到您的 `路径` 环境变量中，则无需设置任何其他选项：pipenv 可执行文件的路径将自动检测。 如果 IntelliJ IDEA 未检测到 pipenv 可执行文件，请点击 通过 pip 安装 pipenv 以允许 IntelliJ IDEA 自动为您安装。 或者，按照 [pipenv 安装过程](null)来查找可执行文件路径，然后在对话框中指定该路径。 6. 点击 OK 完成该任务。 > **Note:** > 如果 IntelliJ IDEA 显示 无效环境 警告，表示指定的 Python 二进制文件在文件系统中找不到，或 Python 版本 [不受支持](python.html#support)。 请检查 Python 路径，并在需要时 [安装新版本](https://www.python.org/downloads/)。 当您将 pipenv 虚拟环境设置为 Python 解释器时，所有可用的软件包会从 `[Pipfile](null)` 中定义的源添加。 可以通过 pipenv 而不是 pip 在包列表中安装、移除和更新包。 有关详细信息，请参阅 [PyCharm 文档](https://www.jetbrains.com/zh-cn/help/pycharm/pipenv.html)。 Procedure: 创建一个 Poetry 环境 1. 转到 `文件 | 项目结构` ，或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。 2. 在 项目结构 对话框中，选择 平台设置 部分下的 SDK ，点击 ![添加新的 SDK](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后从弹出菜单中选择 从磁盘添加 Python SDK... 。 将打开 添加 Python 解释器 对话框。 ![添加新 Python SDK](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png) 3. 以下操作取决于您是想创建一个新的 Poetry 环境还是使用一个现有的环境。 新的 Poetry 环境 : ![生成新的 Poetry 环境](https://resources.jetbrains.com/help/img/idea/2026.3/ij_new_poetry_environment.png) : : 1. 从环境类型列表中选择 Poetry 。 : : 2. : : 从列表中选择基础解释器，或者点击 ![浏览…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中找到 Python 可执行文件。 : : : : 3. : : IntelliJ IDEA 将检测到 Poetry 安装。 : : : : 如果 IntelliJ IDEA 未检测到 Poetry 安装，请点击 通过 pip 安装 poetry 以允许 IntelliJ IDEA 为您自动安装 Poetry。 : : : : 或者，指定 Poetry 可执行文件的位置，或点击 ![浏览…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 进行浏览。 : : : : 4. 要在项目目录中创建虚拟环境，请选中 创建项目内环境 复选框。 现有 Poetry 环境 : ![选择现有 Poetry 环境](https://resources.jetbrains.com/help/img/idea/2026.3/ij_existing_poetry_environment.png) : : 1. 从环境类型列表中选择 Poetry 。 : : 2. : : IntelliJ IDEA 将检测到 Poetry 安装。 : : : : 如果 IntelliJ IDEA 未自动检测到该安装，请指定可执行文件的位置，或点击 ![浏览…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 以浏览并选择它。 : : : : 3. : : 从列表中选择环境。 : : : : 所选的 Poetry 环境将用于当前项目。 4. 点击 OK 完成该任务。 有关详细信息，请参阅 [PyCharm 文档](https://www.jetbrains.com/zh-cn/help/pycharm/poetry.html)。 Procedure: 创建 uv 环境 1. 转到 `文件 | 项目结构` ，或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。 2. 在 项目结构 对话框中，选择 平台设置 部分下的 SDK ，点击 ![添加新的 SDK](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后从弹出菜单中选择 从磁盘添加 Python SDK... 。 将打开 添加 Python 解释器 对话框。 ![添加新 Python SDK](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png) 3. 以下操作取决于要生成新的虚拟环境，还是使用现有虚拟环境。 新的 uv 环境 : ![生成新的 uv 环境](https://resources.jetbrains.com/help/img/idea/2026.3/ij_new_uv_environment.png) : : 1. 从环境类型列表中选择 uv 。 : : 2. : : 从列表中选择基础解释器，或者点击 ![选择基础解释器](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中找到 Python 可执行文件。 : : : : 3. : : IntelliJ IDEA 将检测到 uv 安装。 : : : : 如果 IntelliJ IDEA 未自动检测到安装，请指定 uv 可执行文件的位置，或点击 ![浏览…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 进行浏览。 现有 uv 环境 : ![选择现有 uv 环境](https://resources.jetbrains.com/help/img/idea/2026.3/ij_existing_uv_environment.png) : : 1. 从环境类型列表中选择 uv 。 : : 2. : : IntelliJ IDEA 将检测到 uv 安装。 : : : : 如果 IntelliJ IDEA 未自动检测到安装，请指定 uv 可执行文件的位置，或点击 ![浏览…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 进行浏览。 : : : : 3. 从列表中选择环境。 : : : : 所选 uv 环境将被重新用于当前项目。 4. 点击 OK 完成该任务。 有关详细信息，请参阅 [PyCharm 文档](https://www.jetbrains.com/zh-cn/help/pycharm/uv.html)。 Procedure: 创建 Hatch 环境 1. 转到 `文件 | 项目结构` ，或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。 2. 在 项目结构 对话框中，选择 平台设置 部分下的 SDK ，点击 ![添加新的 SDK](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后从弹出菜单中选择 从磁盘添加 Python SDK... 。 将打开 添加 Python 解释器 对话框。 ![添加新 Python SDK](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png) 3. 以下操作取决于要生成新的虚拟环境，还是使用现有虚拟环境。 新的 Hatch 环境 : ![生成新的 Hatch 环境](https://resources.jetbrains.com/help/img/idea/2026.3/ij_new_hatch_environment.png) : : 1. 从环境类型列表中选择 Hatch 。 : : 2. : : IntelliJ IDEA 将检测到 Hatch 安装。 : : : : 如果 IntelliJ IDEA 未自动检测到安装，请指定 Hatch 可执行文件的位置，或点击 ![浏览…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 进行浏览。 : : : : 3. : : 选择环境。 : : : : Hatch 环境是为各种项目特定任务设计的工作区。 如果未明确选择环境，Hatch 将使用 [默认环境](https://hatch.pypa.io/latest/tutorials/environment/basic-usage/)。 : : : : 4. : : 从列表中选择基础解释器，或者点击 ![选择基础解释器](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中找到 Python 可执行文件。 现有 Hatch 环境 : ![选择现有 Hatch 环境](https://resources.jetbrains.com/help/img/idea/2026.3/ij_existing_hatch_environment.png) : : 1. 从环境类型列表中选择 Hatch 。 : : 2. : : IntelliJ IDEA 将检测到 Hatch 安装。 : : : : 如果 IntelliJ IDEA 未自动检测到安装，请指定 Hatch 可执行文件的位置，或点击 ![浏览…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 进行浏览。 : : : : 3. 从列表中选择环境。 4. 点击 OK 完成该任务。 有关详细信息，请参阅 [PyCharm 文档](https://www.jetbrains.com/zh-cn/help/pycharm/hatch.html)。 ## 配置远程 Python 解释器 要配置远程 Python 解释器： Procedure: 配置 WSL 解释器 1. 请点击屏幕左下角的 Windows 按钮并开始输入 `System Information` 。 为了确保您的系统能够良好运行 WSL， 请将 Windows 升级到最新可用版本。 2. 按照 [WSL 安装指南](https://docs.microsoft.com/en-us/windows/wsl/install-win10)中所述，安装 Windows Subsystem for Linux 并初始化您的 Linux 发行版。 3. 如果您的 Linux 发行版未提供 rsync，您需要安装它： debian: `sudo apt install rsync` arch: `sudo pacman -S rsync` > **Note:** > 使用 WSL 2 时，请注意以下已知的 WSL 问题： > > > > * [向 Windows 防火墙添加 WSL2 网络的 "allow" 规则](https://github.com/microsoft/WSL/issues/4585) > > * [stdin 已被明确关闭用于 Python 进程](https://github.com/microsoft/WSL/issues/4424) > > * 如果未为 WSL IP 打开防火墙，调试器无法正常工作。 4. 转到 `文件 | 项目结构` ，或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。 5. 在 项目结构 对话框中，选择 平台设置 部分下的 SDK ，点击 ![添加新的 SDK](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后从弹出菜单中选择 从磁盘添加 Python SDK... 。 将打开 添加 Python 解释器 对话框。 ![添加新 Python SDK](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png) 6. 从环境类型列表中选择 WSL 。 7. 选择具有所需 Python 解释器的 Linux 发行版。 8. 在 Python 解释器路径 字段中，指定 Python 可执行文件的路径。 可以接受默认值、输入其他路径，或点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) 进行浏览。 ![使用 WSL 添加远程解释器](https://resources.jetbrains.com/help/img/idea/2026.3/py_interpreter_wsl.png) 9. 点击 OK 。 已配置的远程解释器将添加到列表中。 Procedure: 使用 SSH 配置解释器 > **Warning:** > 您不能在配置 SSH interpreters 时使用 Windows 机器作为远程主机。 1. 请确保远程主机上运行着一个 SSH 服务器，因为 IntelliJ IDEA 通过 ssh-session 运行远程解释器。 2. 转到 `文件 | 项目结构` ，或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。 3. 在 项目结构 对话框中，选择 平台设置 部分下的 SDK ，点击 ![添加新的 SDK](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后从弹出菜单中选择 从磁盘添加 Python SDK... 。 将打开 添加 Python 解释器 对话框。 ![添加新 Python SDK](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png) 4. 选择 新的服务器配置 ，然后指定服务器信息（主机、端口和用户名）。 ![通过 SSH 添加解释器](https://resources.jetbrains.com/help/img/idea/2026.3/ij_interpreter_ssh_add.png) 或者，您可以选择 现有服务器配置 并从列表中选择任何可用的部署配置。 ![现有配置](https://resources.jetbrains.com/help/img/idea/2026.3/ij_existing_ssh_configuration.png) 如有需要，请点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)查看所选部署配置的 [连接设置](deployment-connection-tab.html)、 [映射](deployment-mappings-tab.html)和 [排除路径](deployment-excluded-paths-tab.html)。 点击 下一步 继续配置解释器。 5. 在下一个对话框窗口中，提供连接目标服务器的身份验证详细信息。 ![指定身份验证详细信息](https://resources.jetbrains.com/help/img/idea/2026.3/py_ssh_target_2.png) 选择 密码 或 密钥对（OpenSSH 或 PuTTY） 并输入您的密码或密码短语。 如果 密钥对（OpenSSH 或 PuTTY） 被选中，请指定： * 私钥 ：包含私钥的文件位置 * 密码短语 ：类似于密码，它用于 [加密私钥](https://www.ssh.com/ssh/passphrase)。 点击 下一步 继续。 6. 在下一个对话窗口中，验证所需 Python interpreter 的路径。 您可以接受默认值，也可以指定一个不同的值。 您必须配置本地项目和服务器之间的路径映射。 为此，点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) 旁边的 同步文件夹 字段，并输入本地项目文件夹的路径和远程服务器上文件夹的路径。 ![设置 SSH 映射](https://resources.jetbrains.com/help/img/idea/2026.3/py_interpreter_ssh_mappings.png) 还可以选中复选框，以启用将本地更改自动上传到远程服务器。 7. 点击 OK 。 已配置的远程解释器将添加到列表中。 Procedure: 使用 Docker 配置解释器 1. 确保满足以下前提条件： * 已按照 [Docker 文档](https://docs.docker.com)中的说明安装 Docker。 * 网络连接稳定，以便 IntelliJ IDEA 能下载并运行 `busybox:latest` （ [BusyBox Docker 官方镜像](https://hub.docker.com/_/busybox)的最新版本）。 使用 Docker 成功配置解释器后，可以离线工作。 > **Note:** > 您无法将任何 Python 软件包安装到基于 Docker 的项目解释器中。 2. 转到 `文件 | 项目结构` ，或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。 3. 在 项目结构 对话框中，选择 平台设置 部分下的 SDK ，点击 ![添加新的 SDK](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后从弹出菜单中选择 从磁盘添加 Python SDK... 。 将打开 添加 Python 解释器 对话框。 ![添加新 Python SDK](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png) 4. 从环境类型列表中选择 Docker 。 ![使用 Docker 添加 Python 解释器](https://resources.jetbrains.com/help/img/idea/2026.3/interpreter_docker_empty.png) 5. 在 Docker 服务器 下拉菜单中选择一个现有的 Docker 配置。 或者，点击 新建 并执行以下步骤以创建新的 Docker 配置： 创建 Docker 配置 : 点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)以添加 Docker 配置，并指定如何连接到 Docker 守护进程。 : : : : 连接设置取决于您的 Docker 版本和操作系统。 如需更多信息，请参阅 [Docker connection settings](settings-docker.html)。 : : : : 连接成功 消息应出现在对话框的底部。 : : : : ![用于解释器的 Docker 连接设置](https://resources.jetbrains.com/help/img/idea/2026.3/interpreter_docker_config.png) : : 有关在 Windows 或 macOS 上使用 Docker 时将本地路径映射到运行 Docker 守护进程的虚拟机的更多信息，请参阅 [Windows 和 macOS 主机的虚拟机路径映射](settings-docker.html#virtual-machine-path)。 您将无法对映射本地路径之外的目录使用卷和绑定挂载。 : : : : 此表在 Linux 主机上不可用，在该主机上 Docker 本地运行，您可以将任何目录挂载到容器。 6. 请指定图像和 Python 可执行文件的路径： ![使用 Docker 配置 Python 解释器](https://resources.jetbrains.com/help/img/idea/2026.3/interpreter_docker_final.png) 7. 点击 OK 。 已配置的远程解释器将添加到列表中。 Procedure: 使用 Docker Compose 配置解释器 1. 确保满足以下前提条件： * 已按照 [Docker 文档](https://docs.docker.com)中的说明安装 Docker。 * 网络连接稳定，以便 IntelliJ IDEA 能下载并运行 `busybox:latest` （ [BusyBox Docker 官方镜像](https://hub.docker.com/_/busybox)的最新版本）。 使用 Docker 成功配置解释器后，可以离线工作。 > **Note:** > 您无法将任何 Python 软件包安装到基于 Docker 的项目解释器中。 2. 转到 `文件 | 项目结构` ，或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。 3. 在 项目结构 对话框中，选择 平台设置 部分下的 SDK ，点击 ![添加新的 SDK](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后从弹出菜单中选择 从磁盘添加 Python SDK... 。 将打开 添加 Python 解释器 对话框。 ![添加新 Python SDK](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_Python_sdk.png) 4. 从环境类型列表中选择 Docker Compose 。 ![使用 Docker Compose 添加 Python 解释器](https://resources.jetbrains.com/help/img/idea/2026.3/interpreter_docker_compose_empty.png) 5. 在 服务器 下拉菜单中选择 Docker 配置。 6. 请在 `docker-compose.yml` 文件中指定 配置文件 并选择服务。 ![使用 Docker Compose 配置 Python 解释器](https://resources.jetbrains.com/help/img/idea/2026.3/interpreter_docker_compose_final.png) 可选地，指定 [环境变量](https://docs.docker.com/compose/environment-variables/)并编辑 [Compose 项目名称](https://docs.docker.com/reference/cli/docker/compose/#use--p-to-specify-a-project-name)。 7. 最后，指定 Python 可执行文件的路径： ![使用 Docker Compose 配置 Python 解释器](https://resources.jetbrains.com/help/img/idea/2026.3/interpreter_docker_compose_final2.png) 8. 点击 OK 。 已配置的远程解释器将添加到列表中。 有关远程 Python 解释器的更多信息，请参阅 [PyCharm 文档](https://www.jetbrains.com/zh-cn/help/pycharm/using-docker-as-a-remote-interpreter.html)。 ## 移除 Python 解释器 如果您不再需要项目中的 Python 解释器，可以将其从项目设置中移除。 Procedure: 1. 转到 `文件 | 项目结构` ，或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。 2. 在 项目结构 对话框中，点击 SDK 节点下的 平台设置 。 3. 请选择您要删除的解释器，然后点击 ![移除解释器](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)。 ![移除 Python 解释器](https://resources.jetbrains.com/help/img/idea/2026.3/ij_remove_python_interpreter.png) ## 向非 Python 模块添加 Python 支持 要在其他类型的模块中使用 Python 代码，例如 Java 或 Kotlin 模块，请向该模块添加 Python facet，而不是创建单独的 Python 模块。 该 facet 会将所选 Python SDK 作为名称为 ` interpreter library` 的库添加到模块依赖项。 不能向 Python 模块添加 Python facet。 要配置 Python 模块的解释器，请在模块级别选择 Python SDK。 Procedure: 向模块添加 Python facet 1. 在主菜单中，转到 `文件 | 项目结构` （ `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))）。 2. 选择 Facet ，点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后选择 Python 。 3. 在 选择模块 对话框中，选择要向其添加 facet 的模块，然后点击 OK 。 4. 在 Python 解释器 列表中，为模块选择 Python SDK。 5. 应用更改并关闭对话框。 也可以在 模块 页面上添加 facet：选择模块，点击模块树上方的 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后在 框架 部分中选择 Python 。 有关 facet 的更多信息，请参阅 [添加框架（面）](adding-support-for-frameworks-and-technologies.html)。 ## 管理解释器路径 IntelliJ IDEA 使得可以将路径添加到所选解释器。 这些路径将会被添加到环境变量 `PYTHONPATH` 。 IntelliJ IDEA 将为这些路径建立索引并解析代码中的对象（例如，导入包）。 Procedure: 查看解释器路径 1. 转到 `文件 | 项目结构` ，或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。 2. 在 项目结构 对话框中，点击 SDK 节点下的 平台设置 。 3. 请选择解释器。 4. 在 类路径 选项卡中查看解释器路径： ![Classpath 选项卡](https://resources.jetbrains.com/help/img/idea/2026.3/project_structure_python_plugin_sdks.png) Procedure: 添加解释器路径 1. 在 类路径 选项卡中，点击 ![添加](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)。 2. 在打开的对话框中指定路径。 请注意，若要为特定的 Python 版本添加路径，您需要从 [https://www.python.org/](https://www.python.org/) 下载并安装它到您的机器上。 Procedure: 删除解释器路径 1. 选择要在 类路径 选项卡中删除的路径。 2. 点击 ![移除](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)。 > **Note:** > 对于任何配置的 Python 解释器（但基于 Docker 的除外），您可以 [安装、卸载和升级包](https://www.jetbrains.com/zh-cn/help/pycharm/installing-uninstalling-and-upgrading-packages.html)