# CMake 预设

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

[CMake 预设](https://cmake.org/cmake/help/latest/manual/cmake-presets.7.html) 是一种使用两个文件配置和共享 CMake 选项的方法：

* 用于项目作用域的构建的 `CMakePresets.json` 。 此文件可以通过 VCS 共享。

* 用于开发者本地构建的 `CMakeUserPresets.json` 。 此文件不应提交到 VCS。

`CMakePresets.json`  和  `CMakeUserPresets.json`  都具有相同的格式，并应位于项目的根目录中。

> **Note:**
> CLion 支持 2–10 版本的预设，并且仅支持 [configure](https://cmake.org/cmake/help/latest/manual/cmake-presets.7.html#configure-preset) 和 [构建](https://cmake.org/cmake/help/latest/manual/cmake-presets.7.html#build-preset) 预设。

[CMake 配置文件](cmake-profile.html) 与 CMake 预设有许多共同设置，也可以通过 VCS 共享。 主要区别在于配置文件引用了 CLion 的 [工具链](how-to-create-toolchain-in-clion.html)，其中包含 CMake 预设中不存在且不需要的信息（如调试器或环境设置）。

## 预设导入

在打开项目时，CLion 会检测项目根目录下  `CMakePresets.json`  和  `CMakeUserPresets.json`  文件中的所有  构建  和  configure  预设。 默认情况下，所有这些预设都会以只读模式自动加载到 [CMake 配置文件](cmake-profile.html) 中。

> **Tip:**
> 如果您不希望将预设转换为 CMake 配置文件，或者希望排除 configure 或 构建 配置文件，请转到  `设置 | 高级设置`  并使用   自动导入 CMake Presets   开关：
>
> ![CMake 预设启用选项](https://resources.jetbrains.com/help/img/idea/2026.3/cl_advancedsettings_cmake_presets.png)

要查看已加载的预设，请转到  `设置 | 构建、执行、部署 | CMake`  或使用通知对话框中的   视图   链接：

![预设加载通知](https://resources.jetbrains.com/help/img/idea/2026.3/cl_load_presets_notification.png)

* 所有新预设默认情况下都是禁用的，除非您之前已经加载并启用了它们（CLion 会通过名称匹配它们）。

* 如果 `CMakePresets.json` 或 `CMakeUserPresets.json` 文件中不存在之前加载的预设，它们将被移除。

![预设配置文件初始状态](https://resources.jetbrains.com/help/img/idea/2026.3/cl_presets_profiles_initial.png)

> **Note:**
> 预设加载也会由 [重置缓存并重新加载](cmake-cache.html) 和 [加载 CMake 项目](reloading-project.html#CMakeNotDetected) 操作触发。

Procedure: 手动加载预设

您还可以为已打开的项目加载预设。

1. 调用  `帮助 | 查找操作` （ `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `⌘ ⇧ A` (Xcode), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+Shift+A` (ReSharper), `⌘ ⇧ A` (ReSharper (macOS)), `Ctrl+Shift+A` (QtCreator), `⌘ ⇧ A` (QtCreator (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS))）并搜索  加载 CMake 预设 。

2. CLion 将显示一个弹窗，其中列出了现有的构建预设：

![加载 CMake 预设弹窗](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakepresets_popup.png)

3. 选择预设并按下 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。

您可以通过按住 `Ctrl` (Windows), `Ctrl` (macOS), `Ctrl` (IntelliJ IDEA Classic (macOS)), `Ctrl` (macOS System Shortcuts), `Ctrl` (XWin), `Ctrl` (GNOME), `Ctrl` (KDE), `Ctrl` (Emacs), `Ctrl` (Sublime Text), `Ctrl` (Sublime Text (macOS)), `Ctrl` (Xcode), `Ctrl` (Visual Studio), `Ctrl` (Visual Studio (macOS)), `Ctrl` (ReSharper), `Ctrl` (ReSharper (macOS)), `Ctrl` (QtCreator), `Ctrl` (QtCreator (macOS)), `Ctrl` (NetBeans), `Ctrl` (Eclipse), `Ctrl` (Eclipse (macOS)) 或 `Shift` (Windows), `Shift` (macOS), `Shift` (IntelliJ IDEA Classic (macOS)), `Shift` (macOS System Shortcuts), `Shift` (XWin), `Shift` (GNOME), `Shift` (KDE), `Shift` (Emacs), `Shift` (Sublime Text), `Shift` (Sublime Text (macOS)), `Shift` (Xcode), `Shift` (Visual Studio), `Shift` (Visual Studio (macOS)), `Shift` (ReSharper), `Shift` (ReSharper (macOS)), `Shift` (QtCreator), `Shift` (QtCreator (macOS)), `Shift` (NetBeans), `Shift` (Eclipse), `Shift` (Eclipse (macOS)) 选择多个条目。 CLion 将加载所有选定的预设。

4. 与打开项目的情况类似，您手动加载的预设会以只读模式导入到 CMake 配置文件中。 您可以在  `设置 | 构建、执行、部署 | CMake`  中找到它们。

Procedure: 启用预设配置文件

1. 转到  `设置 | 构建、执行、部署 | CMake` 。

2. 选择所需的配置文件并设置   启用配置文件   复选框：

![正在启用预设配置文件](https://resources.jetbrains.com/help/img/idea/2026.3/cl_presets_enable.png)

> **Tip:**
> 要使用启用的配置文件构建项目，请在配置切换器中选择它并构建 ![构建按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.toolwindows.toolWindowBuild.svg) 配置，或调用可用的 [构建操作](build-actions.html) 之一。 请参阅 [使用配置文件构建](cmake-profile.html#CMakeProfileSwitcher)。

## 编辑预设

您可以使用以下两种选项编辑导入的预设：

* [编辑基于预设的 CMake 配置文件的副本](#presets-copy-edit)

* [在编辑器中修改相应的 JSON 文件](#edit-presets-json)

Procedure: 编辑基于预设的 CMake 配置文件的副本

1. 转到  `设置 | 构建、执行、部署 | CMake` 。

2. 选择所需的配置文件并点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.copy.svg) 或按下  `Ctrl/⌘ + D` ：

![复制基于预设的配置文件](https://resources.jetbrains.com/help/img/idea/2026.3/cl_presets_copyaction.png)

3. 调整复制的配置文件中的设置：

![编辑已复制的基于预设的配置文件](https://resources.jetbrains.com/help/img/idea/2026.3/cl_presets_edit_copied.png)

Procedure: 在编辑器中修改相应的 JSON 文件

* 打开并开始编辑相应的  `json`  文件。 CLion 将在您输入时跟踪更改，并在问题视图中通知您任何错误：

![CMake 预设错误报告](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakepresets_errors.png)

* 当您在编辑器中更改预设文件或在外部修改它时，您将收到建议重新加载更改的通知：

![编辑 CMake 预设 JSON 文件](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakepresets_editing.png)

* 如果您希望 CLion 静默重新加载更改，请点击   启用自动重载  。 这将在配置文件设置中设置相应的复选框：

![CMake 配置文件自动重新加载](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakepresets_autoreload.png)

### 更改工具链

默认情况下，加载的预设会链接到默认的 CLion [工具链](how-to-create-toolchain-in-clion.html)。

要设置已配置的工具链之一，请修改  configure  预设的供应商特定字段。

例如，使用以下代码切换到名为 Clang10 的工具链：

```JSON
"vendor": {
    "jetbrains.com/clion": {
      "toolchain": "Clang10"
    }
}

```

结果是，Clang10 工具链将被分配给加载的预设：

![已加载的 CMake 预设](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakepreset_profile.png)

在 Windows 上，如果您使用的是 [MSVC 工具链](quick-tutorial-on-configuring-clion-on-windows.html#MSVC)，  configure  预设中的架构和工具集属性也会被提取到 CMake 选项中：

![CMake 预设 MSVC 选项](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakepresets_windows_options.png)

## 条件支持

CLion 支持  `condition`  字段，用于在  `CMakePresets.json`  和  `CMakeUserPresets.json`  文件中过滤预设。 请注意，仅支持  `equals`  和  `notEquals`  类型。

以下是按平台过滤预设的示例：

```JSON
{
    "name": "windows-only",
    "inherits": "default",
    "displayName": "Windows-only configuration",
    "description": "This build is only available on Windows",
    "condition": {
      "type": "equals",
      "lhs": "${hostSystemName}",
      "rhs": "Windows"
  }
}

```

配置按平台过滤后，相应的预设将仅出现在为其启用的平台的 [预设配置文件列表](cmake-profile.html) 中。

在 [CMake 文档](https://cmake.org/cmake/help/latest/manual/cmake-presets.7.html#condition) 中了解有关  `condition`  字段选项的更多信息。

## Python 集成

如果您的项目配置了 [Python 解释器](python-interpreter-for-cmake-projects.html)，它也可以传递到 CMake 预设中。 这需要在预设属性中显式设置  `enablePythonIntegration`  标志。 以下是一个示例：

```JSON
...
  "configurePresets": [
    {
      "name": "default",
      "vendor": {
        "jetbrains.com/clion": {
          "toolchain": "Default",
          "enablePythonIntegration": true
        }
      }
    }
  ],
...

```

配置  `vendor`  字段后，Python 解释器将被传递到相应的 CMake 配置文件中。

## See also

### 教程

[快速 CMake 教程](quick-cmake-tutorial.html)

### 操作指南

[CMake 配置文件](cmake-profile.html) [加载/重新加载 CMake](reloading-project.html) [工具链](how-to-create-toolchain-in-clion.html)

### 参考

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

