# CMake 项目的 Python 解释器

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

> **TL;DR**
> 工具链  ：除 [Remote](remote-projects-support.html)、 [WSL](how-to-use-wsl-development-environment-in-product.html) 和 [Docker](clion-toolchains-in-docker.html) 外的所有内容
>
>
>
> 默认状态  ：启用
>
>
>
> 必需插件  ：Python（捆绑）

CLion 的 CMake 集成包含 Python 插件。 这意味着当您的项目配置了 [Python 解释器](configuring-available-python-interpreters.html)时，CMake 会将其与所有与 Python 相关的环境变量一起加载。

> **Note:**
> 对于在 CMake Options 中定义了 Python 变量的配置文件，此集成不起作用。

Procedure: Python 与 CMake 集成的设置

* Python 与 CMake 的集成由两个选项控制：

1.  IDE 作用域的选项位于 [高级设置](advanced-settings.html)，

2.  项目作用域的选项位于  `设置 | 构建、执行、CMake | Python 集成` 。

项目作用域和 IDE 作用域的选项默认均为启用状态。

在这些设置发生任何更改时，CLion 会执行 [CMake 缓存重置和项目重新加载](cmake-cache.html#reset-cache)。

Procedure: 为当前 CMake 项目禁用 Python 集成

1. 转到  `设置 | 构建、执行、CMake | Python 集成` 。

2. 清除   将 Python 解释器传递给 CMake  复选框。

![正在禁用当前项目的 Python 集成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_disable_python_cmake_prj.png)

> **Note:**
> IDE 作用域的选项将保持启用状态。

Procedure: 为所有 CMake 项目禁用 Python 集成

1. 转到  `设置 | 高级设置` 。

2. 在   CMake  部分，清除   将 Python 解释器传递给 CMake  复选框。

![正在禁用所有项目的 Python 集成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_disable_python_cmake_ide.png)

> **Tip:**
> 对于未打开的项目，Python 变量将保留在 CMake 缓存中。 要移除它们，请为每个项目调用 [Reset Cache and Reload Project](cmake-cache.html#reset-cache)。

## See also

### 概念

[CMake 配置文件](cmake-profile.html) [CMake 预设](cmake-presets.html)

### 设置

[高级设置](advanced-settings.html)

### 操作指南

[配置 Python 解释器](configuring-available-python-interpreters.html)

