# CMake 配置文件

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

构建 CMake 项目所需的设置已集成到   CMake 配置文件   中。 它包括 [toolchain](how-to-create-toolchain-in-clion.html)和 [构建 type](#buildtypes)，以及 CMake 选项，例如 [generators](#cmake-generators)和 [environment variables](#EnvVariables)。

您可以为项目配置多个配置文件，例如使用不同的编译器或以不同的设置构建目标。

Procedure: 访问配置文件设置

执行以下操作之一以打开 CMake 配置文件设置。

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

* 按 `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 设置 ：

![在 Find Action 中的 CMake 设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_settings_findaction.png)

* 转到  `设置 | 键位图` 并 [为 CMake 设置分配快捷键](configuring-keyboard-and-mouse-shortcuts.html#add-keyboard-shortcut)。 使用此快捷键快速打开 CMake 设置页面。

![为 CMake 设置分配快捷键](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_settings_keymap.png)

> **Note:**
> CMake 配置文件是按项目配置的。

Procedure: 添加新配置文件

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

2. 点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，CLion 将在列表中添加一个新配置文件。

3. 如有需要，请更改配置文件名称、构建类型和其他设置。

Procedure: 使用配置文件进行构建

1. 启用的配置文件列在配置文件切换器中。

在构建、运行或调试应用程序之前选择所需的配置文件。

![配置切换器中的 cmake 配置文件](https://resources.jetbrains.com/help/img/idea/2026.3/cl_profileSwitcher.png)

> **Note:**
> CLion 根据所选目标是否支持该配置文件来过滤此切换器中建议的配置文件列表。 例如：
>
>
>
> 假设您有两个配置文件，Debug 和 Release，以及一个名为  `debug_target` 的目标，该目标仅支持 Debug：
>
>
>
>
> ```CMAKE
> if(${CMAKE_BUILD_TYPE} STREQUAL "Debug")
> add_executable(debug_target main.cpp)
> endif()
>
> ```
>
>
>
> 如果您在 [运行/调试配置](run-debug-configuration.html) 中选择此目标，CLion 只会建议 Debug 配置文件。

> **Note:**
> CMake 配置文件定义项目的构建方式。},{ 要为调试会话选择调试器，请在相同工具栏的独立调试配置切换器中选择 [调试配置](debug-profiles.html)。

2. 点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.build.build.svg)或调用可用的 [构建操作](build-actions.html)之一。

此外，默认情况下，在运行 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg) 或调试 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.startDebugger.svg) 之前会执行构建（您可以在配置设置中更改此项）。

Procedure: 为新项目配置默认配置文件

1. 转到  `文件 | 新项目设置 | 构建、执行、部署 | CMake` 。

2. 配置默认用于所有 [新项目](creating-new-project-from-scratch.html)的配置文件列表。

Procedure: 共享配置文件

您可以在 VCS 中与项目一起共享 CMake 配置文件。 配置文件的设置存储在  `cmake.xml`  中的  `.idea`  目录中。

* 选择您想要共享的配置文件并设置   共享  复选框：

![共享的 CMake 配置文件](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakeprofile_shared.png)

共享的配置文件会自动移至列表底部。

> **Note:**
> 只有   配置文件   设置可以共享。   在编辑 CMakeLists.txt 或其他 CMake 配置文件时重新加载 CMake 项目   选项对所有配置文件通用，并存储在  `workspace.xml`  中。

请确保共享配置文件和本地配置文件的名称不同。 如果共享配置文件和本地配置文件具有相同的名称，本地配置文件将优先，您将在设置中看不到共享配置文件。

Procedure: 禁用/启用配置文件

您可以禁用当前未使用的配置文件，以节省加载时间并避免潜在错误（例如，当您有一个不经常使用的远程配置文件且机器已关闭时）。

> **Note:**
> [预设](cmake-presets.html) 配置文件默认是禁用的。

> **Note:**
> 当您启用或禁用配置文件时，CLion 会增量重新加载 CMake，而不管   在编辑 CMakeLists.txt 或其他 CMake 配置文件时重新加载 CMake 项目   控制。
>
>
>
> 重新加载 CMake 时，所有配置文件会并行重新加载。 这可能会导致某些配置出现问题。 为解决此问题，请在  `设置 | 高级设置 | CMake`  中选择   按顺序重新加载 CMake 配置文件   选项。

使用以下选项之一：

* 在  `设置 | 构建、执行、部署 | CMake`  中清除或设置   启用配置文件   复选框。 已禁用的配置文件在列表中显示为灰色。

![已禁用的配置文件](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_disabledprofiles.png)

* 要禁用已成功加载的配置文件，请从   CMake   工具窗口的配置菜单中选择   禁用此配置文件  ：

![从 CMake 工具窗口禁用已加载的配置文件](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_disableprofile_fromtw.png)

在此菜单中，您还可以启用任何已禁用的配置文件：

![从 CMake 工具窗口启用已禁用的配置文件](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakeprofile_enable_fromtw.png)

## CMake 选项

Procedure: 编译器标志

在 CLion 中，您可以在配置文件的   CMake 选项   字段或  `CMakeLists.txt`  脚本中指定编译器标志。

* 使用 CMake 选项：

在  `设置 | 构建、执行、部署 | CMake`  中选择配置文件并编辑   CMake 选项   字段。

使用  `-D`  和  `CMAKE_CXX_FLAGS`  变量（或  `CMAKE_C_FLAGS`  用于   C   项目）。 例如，  `-DCMAKE_CXX_FLAGS="-Wall -Wextra"` 。

> **Note:**
> 您可以在 [缓存变量](#cmake-cache-variables) 表中更改现有 CMake 变量的值。

![在 CMake 选项中设置编译器标志](https://resources.jetbrains.com/help/img/idea/2026.3/cl_compilerlfags_cmakeoptions.png)

CLion 还支持传递给   CMake 选项   的  `--preset`  参数。 指定的 [预设](cmake-presets.html) 的数据会加载到构建类型、工具链和构建目录设置中。

> **Tip:**
> 点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 插入项目根目录宏。 有关更多信息，请参阅 [CMake 设置参考页面](cmake0.html)。

* 或者，您可以在 [CMakeLists.txt](cmakelists-txt-file.html) 中设置编译器标志。

添加以下命令并包含所需的标志：

```CMAKE
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -Wextra")
```

Procedure: CMake 工具链文件

* 在   CMake 选项   中，您可以使用 [CMAKE_TOOLCHAIN_FILE](https://cmake.org/cmake/help/latest/variable/CMAKE_TOOLCHAIN_FILE.html) 变量指定 CMake 工具链文件。

## CMake 缓存变量

您可以在   缓存变量   表中查看和编辑 CMake 缓存变量：

![CMake 缓存变量](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_variables.png)

您可以在 [CMake 选项](#compiler-flags) 字段或 [CMakeLists.txt](cmakelists-txt-file.html) 文件中添加新变量。 用户定义的变量位于表的顶部。 用户定义变量的值以粗体显示，而其他变量的更改值以斜体显示：

![自定义 CMake 变量](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_custom_variables.png)

要从   CMake 选项   字段中移除变量，请在表中选择它并点击 !["移除"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.popFrame.svg) 或按 `Alt+Delete` (Windows), `⌘ ⌦` (macOS), `⌘ ⌦` (IntelliJ IDEA Classic (macOS)), `⌘ ⌦` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `⌘ ⌦` (Sublime Text (macOS)), `⌘ ⌦` (Xcode), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (ReSharper), `⌥ ⌦` (ReSharper (macOS)), `Alt+Delete` (QtCreator), `⌘ ⌦` (QtCreator (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))。 变量将从表中移除，或者其值将在 [重置 CMake 缓存](cmake-cache.html#reset-cache) 后设置为默认值。

要放弃当前会话中所做的更改，请选择一个变量并点击 ![还原 图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.diff.revert.svg) 或按 `Ctrl+Z` (Windows), `⌘ Z` (macOS), `⌘ Z` (IntelliJ IDEA Classic (macOS)), `⌘ Z` (macOS System Shortcuts), `Ctrl+Z` (XWin), `Ctrl+Z` (GNOME), `Ctrl+Z` (KDE), `Ctrl+Shift+Minus` (Emacs), `Ctrl+Z` (Sublime Text), `⌘ Z` (Sublime Text (macOS)), `⌘ Z` (Xcode), `Ctrl+Z` (Visual Studio), `⌘ Z` (Visual Studio (macOS)), `Ctrl+Z` (ReSharper), `⌘ Z` (ReSharper (macOS)), `Ctrl+Z` (QtCreator), `⌘ Z` (QtCreator (macOS)), `Ctrl+Z` (NetBeans), `Ctrl+Z` (Eclipse), `⌘ Z` (Eclipse (macOS))。

高级 CMake 变量默认是隐藏的，但您可以通过选择   显示高级选项   复选框来显示它们：

![显示高级 CMake 变量](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_variables_advanced.png)

CLion 还会在工具提示中显示 CMake 缓存变量的简短描述：

![带有工具提示的布尔变量](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_vars_boolean.png)

IDE 将布尔值显示为复选框。 在复选框旁边，您可以看到布尔变量背后的实际值。 以下值被视为  `False` ：  `0` 、  `关闭` 、  `NO` 、  `N` 、  `IGNORE` 、  `NOTFOUND` 、空字符串以及以后缀  `-NOTFOUND`  结尾的值。 在所有其他情况下，该值被视为  `True` 。

当您在 CLion 用户界面中选中或取消选中复选框时，以下值对用于配置选项值：  `0-1` 、  `OFF-ON` 、  `NO-YES` 、  `FALSE-TRUE`  和  `N-Y` 。 对于任何其他值，IDE 会将复选框状态转换为  `OFF-ON` 。

> **Note:**
> 命名的布尔常量不区分大小写。

## 生成器

在   生成器   字段中，您可以在 [CMake 生成器](https://cmake.org/cmake/help/latest/manual/cmake-generators.7.html) 之间切换。 使用所选工具链的默认值或从预定义列表中设置另一个生成器：

![指定自定义 CMake 生成器](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakeprofile_generators.png)

|    使用默认值    |     CLion 使用 [Ninja](https://ninja-build.org/) 或 Makefiles 作为默认生成器。         Ninja   在以下  所有 条件为真时使用：        * 所选的 [工具链](how-to-create-toolchain-in-clion.html) 是本地的（这不包括 [Remote](remote-projects-support.html#remote-toolchain)、 [Docker](clion-toolchains-in-docker.html) 和 [WSL](how-to-use-wsl-development-environment-in-product.html)）。    * 为所选工具链配置的构建工具是 Ninja（捆绑的 Ninja 是默认构建工具）。    * CMake 版本为 3.20 或更高。    * 项目首次在 CLion 2021.3 中创建或打开。    * 对于 CMake 3.20 及更高版本使用旧版生成器 复选框在 [高级设置](advanced-settings.html) 中未设置。      在所有其他情况下，将使用   Makefiles   生成器。     |
|    让 CMake 决定    |  如果您选择此选项，CLion 不会强制显式使用任何生成器，CMake 将决定使用哪个生成器。 默认情况下，这由 [CMAKE_GENERATOR](https://cmake.org/cmake/help/latest/envvar/CMAKE_GENERATOR.html#envvar:CMAKE_GENERATOR)环境变量控制。  |

或者，您可以通过   CMake 选项   和  `-G`  设置生成器。 当使用   生成器  字段时，CLion 会自动更新   CMake 选项  ，反之亦然：

![CMake 选项中的 CMake 生成器](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakeprofiles_generator_options.png)

> **Note:**
> CMake 配置文件的实际构建工具取自所选的 [工具链](how-to-create-toolchain-in-clion.html)。

### 当前限制

* CLion 使用 [CMake File API](https://cmake.org/cmake/help/v3.15/manual/cmake-file-api.7.html)，该 API 首次出现在 CMake v3.14 中。 但是，CLion 支持的最低 CMake 版本为 3.15.，因此如果决定不使用自带的 CMake，请确保使用 3.15..x 或更高版本 。

* 对于多配置生成器（如 Ninja Multi-Config、Xcode 或 Visual Studio），CLion 仅使用与 CMake 配置文件中指定的 [构建类型](#buildtypes) 对应的配置（ [CPP-20890](https://youtrack.jetbrains.com/issue/CPP-20890)）。

## 构建类型

使用   构建类型  字段设置以下 [CMake 构建类型](https://cmake.org/cmake/help/latest/variable/CMAKE_BUILD_TYPE.html)之一：

* 默认（对应于 CMAKE_构建_TYPE 的 空 值）。

* Debug（默认构建类型）

* Release

* RelWithDebInfo（带调试信息的 Release）

* MinSizeRel（针对大小优化的 Release）

要在  `CMakeLists.txt`  中引用构建类型，请使用  `CMAKE_BUILD_TYPE`  变量。 例如：

```CMAKE
if (CMAKE_BUILD_TYPE MATCHES Debug)
    add_definitions(-DDEBUG=1)
endif()
            
```

您还可以根据当前构建类型在代码中创建条件语句：

```CPLUSPLUS
int main(int argc, const char* argv[]) {
#if DEBUG
...
#else
...
#endif

```

### 自定义构建类型

可用构建类型的列表由  `CMAKE_CONFIGURATION_TYPES`  命令定义。 此命令的默认值是上述四种构建类型，但您可以扩展它以包含其他构建类型。 例如：

```CMAKE
# adding two custom build types to the cached value
# variable CMAKE_CONFIGURATION_TYPES should be defined before other definitions:
set(CMAKE_CONFIGURATION_TYPES "MyDebug;MyRelease" CACHE STRING "" FORCE)

```

重新加载项目后，自定义类型将可从 CMake 设置中使用：

![自定义构建类型](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_custom_buildtypes.png)

请注意，自定义类型已添加到缓存的  Debug  值中  `CMakeCache.txt` 。 因此，例如，如果您添加一个新的 CMake 配置文件，它将有自己的  `CMakeCache.txt` ，对于此配置文件，可用构建类型的列表将仅包含您的自定义类型：

![用于新 cmake 配置文件的自定义构建类型](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_custom_buildtypes_profiles.png)

## 构建选项

在   构建选项  字段中，您可以设置选项，这些选项将传递给 CMake 使用的构建工具或作为命令行参数传递给 CMake 本身。 这些选项将在 [构建](https://cmake.org/cmake/help/latest/manual/cmake.1.html#build-a-project)阶段使用。

底层构建工具（make、Ninja 或其他工具）的参数应以  `--` 为前缀。 例如，如果您指定  `-j 5 --clean-first -- -d -p` ，则  `-j 5 --clean-first` 将由 CMake 处理，而  `-d -p` 将传递给构建工具。

当此字段中未指定任何内容时，CLion 使用取决于所选环境的默认设置。 例如，并行运行的构建进程的默认设置为  `-- -j max(cpucount * 0.8, cpucount - 2)` （适用于   make   和   Ninja  ），而对于 [Microsoft Visual C++](quick-tutorial-on-configuring-clion-on-windows.html#MSVC)，此选项未设置且字段为空。

## 环境变量

您可以通过   环境   字段在  `CMake 设置`  对话框中传递其他环境变量（导航到  `设置 | 构建、执行、部署 | CMake` ）。

> **Note:**
> 您在配置文件中指定的环境变量会影响 CMake 生成和构建，但不会影响二进制启动。

CMake 生成和构建的   整体影响环境   包括：

* 父环境 要包含父环境，请通过点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.inlineVariables.svg) 或按 `Shift+Enter` (Windows), `⇧ ⏎` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⇧ ⏎` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⇧ ⏎` (Sublime Text (macOS)), `⇧ ⏎` (Xcode), `Shift+Enter` (Visual Studio), `⇧ ⏎` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⇧ ⏎` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `⇧ ⏎` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⇧ ⏎` (Eclipse (macOS)) 打开 环境变量 对话框，并设置 包含系统环境变量 复选框。 您另外指定的值将附加到系统变量中。 否则，当复选框被清除时，您的自定义值将覆盖系统值。

* 工具链环境 这些是由所选工具集定义的变量（例如， `vcvarsall.bat` 对于 [MSVC](quick-tutorial-on-configuring-clion-on-windows.html#MSVC) 或路径变量，如 `mingw/bin` ），或者来自 [环境初始化脚本](how-to-create-toolchain-in-clion.html#env-scripts) 的变量。 > **Tip:** > 您可以使用 [工具链环境脚本](how-to-create-toolchain-in-clion.html#env-scripts)从文件中设置 CMake 变量。

* CMake 配置文件环境 您在 环境 字段中指定的自定义变量。

您可以使用  `$VAR$`  语法引用现有变量，包括父环境变量。 请注意，此类引用区分大小写：例如，  `PATH=xxx:$PATH$` 用于 Linux/macOS，  `Path=xxx;$Path$` 用于 Windows。 引用现有变量目前不适用于 [远程工具链](remote-projects-support.html)（ [CPP-15693](https://youtrack.jetbrains.com/issue/CPP-15693)）。

## See also

### 参考

[CMake Profile settings](cmake0.html)

### 操作指南

[CMakeLists.txt](cmakelists-txt-file.html) [CMake 性能分析](cmake-profiling.html) [编译器](how-to-switch-compilers-in-clion.html) [工具链](how-to-create-toolchain-in-clion.html) [构建操作](build-actions.html) [运行/调试配置](run-debug-configuration.html)

