# 配置 Python 解释器

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

可用于各种项目的 Python SDK 列表可以包括本地安装的解释器以及虚拟环境。 以下描述的过程假定必要的 Python 解释器已安装在您的计算机上。

Procedure: 添加 Python 解释器

1. 转到  `设置 | 构建、执行、部署 | Python 解释器` 。

2. 点击   添加解释器   字段旁的   Python 解释器  。

3. 选择解释器类型并设置配置：

虚拟环境:

Procedure:

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

![创建虚拟环境](https://resources.jetbrains.com/help/img/idea/2026.3/py_create_virtual_environment.png)

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

新虚拟环境
: * 从列表中选择基础解释器，或点击 ![选择基础解释器](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中查找 Python 可执行文件。
:
: * 在 位置 字段中指定新虚拟环境的位置，或点击 ![虚拟环境位置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中浏览该位置。 新虚拟环境的目录应为空。
:
: * 如果要将计算机上的全局 Python 中安装的所有软件包添加到将要创建的虚拟环境中，请选中 继承基础解释器中的包 复选框。 此复选框对应 `--system-site-packages` 选项的 [virtualenv](http://www.virtualenv.org/en/latest/index.html) 工具。

现有虚拟环境
: * 从列表中选择所需的解释器。
:
: * 如果所需的解释器不在列表中，请点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)，然后浏览所需的 Python 可执行文件（例如，在 macOS 上 `venv/bin/python` 或在 Windows 上 `venv\Scripts\python.exe` ）。
:
: 已选择的虚拟环境将为当前项目重复使用。

3. 点击   确定  完成任务。

> **Note:**
> 如果 CLion 显示   无效环境   警告，表示指定的 Python 二进制文件在文件系统中找不到，或 Python 版本 [不受支持](python.html#support)。 请检查 Python 路径，并在需要时 [安装新版本](https://www.python.org/downloads/)。

Conda:

Procedure:

1. 确保 [Anaconda](https://www.continuum.io/) 或 [Miniconda](https://conda.io/en/latest/miniconda.html) 已下载并安装在您的计算机上，并且您知道其可执行文件的路径。

如需更多信息，请参阅 [安装说明](https://docs.anaconda.com/anaconda/install/)。

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

![新 Conda 环境](https://resources.jetbrains.com/help/img/idea/2026.3/py_add_conda_interpreter.png)

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

新 conda 环境
: 1.  从环境类型列表中选择   Conda  。
:
: 2.  从列表中选择 Python 版本。
:
: 3.  指定环境名称。
:
: 4.
:
: CLion 将检测到 conda 安装。
:
:
:
: 如果 CLion 未自动检测到该安装，请指定 conda 可执行文件的位置，或点击 ![Conda 可执行文件位置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 进行浏览。

现有 conda 环境
: 1.  从列表中选择环境。
:
:
:
: 所选的 conda 环境将被重新用于当前项目。

4. 点击   确定  完成任务。

系统:

Procedure:

1. 确保您已在计算机上下载并安装 [Python](https://www.python.org/downloads/)。

从 Microsoft Store 安装 Python
: 如果您使用的是 Windows，您可以从 Microsoft Store 下载 Python 并将其安装为 Python 解释器。 一旦从 Microsoft Store 下载 Python 应用程序，它就会出现在 Python 可执行文件列表中。
:
:
:
: 请注意，从 Microsoft Store 安装的解释器有一些限制。 由于对 Microsoft Store 应用的限制，Python 脚本可能无法完全写入共享位置，如  `TEMP`  和注册表。

2. 从环境类型列表中选择   系统解释器  。

![添加系统解释器](https://resources.jetbrains.com/help/img/idea/2026.3/py_add_system_interpreter.png)

3. 在   解释器   下拉菜单中，选择已安装在系统中的一个 Python 解释器，或点击 ![“浏览”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)，然后在打开的   选择 C/C++ 解释器   对话框中选择所需的 C/C++ 可执行文件。

![选择 Python 可执行文件](https://resources.jetbrains.com/help/img/idea/2026.3/py_select_python_executable.png)

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

![系统解释器警告消息](https://resources.jetbrains.com/help/img/idea/2026.3/py_system_interpreter_warning.png)

建议您为项目使用虚拟环境。

4. 点击   确定  完成任务。

Pipenv 环境:

Procedure:

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

![添加 Pipenv 环境](https://resources.jetbrains.com/help/img/idea/2026.3/py_pipenv_add.png)

2. 从列表中选择基本解释器，或点击 ![选择基础解释器](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg)并在您的文件系统中找到 Python 可执行文件。

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

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

如果未找到 pipenv 可执行文件，请按照 [pipenv 安装程序](pipenv.html#executable-path) 发现可执行文件路径，然后在对话框中指定它。

5. 点击   确定  完成任务。

Poetry:

Procedure:

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

![创建一个诗意环境](https://resources.jetbrains.com/help/img/idea/2026.3/py_create_poetry_environment.png)

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

新的 Poetry 环境
: 1.  请选择   Poetry 环境  。
:
: 2.
:
: 从列表中选择基础解释器，或点击 ![浏览…](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.browse.svg) 并在文件系统中查找 Python 可执行文件。
:
:
:
: 3.  如果您的项目包含  `pyproject.toml` ，您可以通过启用或禁用   从 pyproject.toml 安装包  复选框来选择是否安装其中列出的包。 默认情况下，复选框是启用的。

现有 Poetry 环境
: 1.  从环境类型列表中选择   Poetry  。
:
: 2.  请选择   现有环境  。 然后展开   解释器   列表并选择解释器。
:
: 所选的 Poetry 环境将用于当前项目。

3. 点击   确定  完成任务。

Procedure: 为项目设置 Python 解释器

1. 在 [配置 Python 解释器](#configure-interpreters)后，可以从列表中选择其中一个：

![可用 Python 解释器列表](https://resources.jetbrains.com/help/img/idea/2026.3/cl_python_interpreters_list.png)

2. 点击   Apply   为您的项目设置所选的解释器。

## See also

### 概念

### 流程

[CMake 项目的 Python 解释器](python-interpreter-for-cmake-projects.html)

