# CMake

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

> **TL;DR**
> `设置 | 构建、执行、部署 | CMake`

使用此页面配置当前项目的 [CMake 配置文件](cmake-profile.html) 设置。

![CMake 设置对话框](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakesettings_overview.png)

|  项  |  描述  |
| --- | --- |
|  在编辑 CMakeLists.txt 或其他 CMake 配置文件时重新加载 CMake 项目  |     如果选中此复选框，CLion 会在您编辑 [CMakeLists.txt](cmakelists-txt-file.html) 或 [CMakePresets.json](cmake-presets.html) 时自动重新加载您的项目。       如果清除此复选框，CLion 会显示一条弹出消息，可在其中选择手动重新加载当前项目或启用自动重新加载（这会选中此复选框）：      ![CMake 重新加载选项](https://resources.jetbrains.com/help/img/idea/2026.3/cl_reload_cmake.png)    但是，如果发生某些外部更改（例如，从版本控制更新），项目仍会重新加载。     |

## 配置文件

|  项  |  描述  |
| --- | --- |
|  配置文件  |     在此字段中，选择一个 [CMake 配置文件](cmake-profile.html)。 您可以在此处编辑、删除或添加配置文件。        * 点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 按钮将配置文件添加到列表中。 默认情况下，配置文件的命名基于当前选择的构建类型和工具链。    * 点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg) 按钮从列表中删除选定的配置文件。    * 点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置](run-debug-configuration.html) 切换器中可用的配置文件以及 [解析上下文](switching-resolve-context.html) 列表。     |
|  启用配置文件  |  如果禁用某个配置文件，它将不会包含在 CMake 重新加载中。 使用此选项禁用您当前不需要的配置文件。  |
|  名称  |  此字段表示选定配置文件的名称。  |
|  构建类型  |     从此下拉列表中选择所需的 [构建类型](cmake-profile.html#buildtypes)。       默认情况下，如果此字段未手动设置，类型为   调试  。       请注意，   默认   选项对应于 [CMAKE_BUILD_TYPE](https://cmake.org/cmake/help/latest/variable/CMAKE_BUILD_TYPE.html) 的空值。     |
|  工具链  |     从此下拉列表中选择所需的工具链。 此列表包含在工具链设置对话框中创建的工具链。       如果未选择任何内容，CLion 将使用当前设置为默认值的 [工具链](how-to-create-toolchain-in-clion.html)（工具链列表中的第一个）。     |
|  生成器  |     可在此处选择 [CMake 生成器](cmake-profile.html#cmake-generators)：      ![生成器下拉菜单](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakeprofile_generators_dropdown.png)    或者，您可以通过   CMake 选项   设置生成器。 CLion 会相应地更新这两个字段。     |
|  CMake 选项  |     在此字段中，指定额外的 [CMake 选项](https://cmake.org/cmake/help/latest/manual/cmake.1.html#options)，以空格分隔。       例如，您可以通过  `-G`  在此处指定自定义 [CMake 生成器](cmake-profile.html#cmake-generators)。      > **Tip:** > 随时可以按 `Shift+Enter` (Windows), `⇧ ⏎` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⇧ ⏎` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Ctrl+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)) 或点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.expandComponentHover.svg) 在编辑器窗口中输入，每行一个选项。      您还可以通过点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 在此字段中插入项目路径宏：      ![CMake 选项宏](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakeoptions_macros.png)  |
|  构建目录  |     在此处指定生成的 CMake 文件的所需位置。 此路径可以是绝对路径（例如，  `c:\CLion_Projects\My_Project\cmake-build-debug` ）或相对于当前项目根目录的相对路径（例如，  `cmake-build-debug` ）。       将此字段留空以使用默认位置，即项目根目录下的  `cmake-build-[buid_type]` 。       此设置保存在  `.idea/workspace.xml`  中，不应共享。      > **Note:** > 如果选择项目根目录的子目录作为生成输出，IDE 会将该子目录中的文件标记为从项目中排除，并将其视为非项目文件。 类似   导航到文件   的导航操作将无法对这些文件起作用。    |
|  构建选项  |     在此字段中，指定要传递给 CMake 所用构建工具的选项，或作为命令行参数传递给 CMake 本身的选项。       此字段中的选项会在构建阶段传递给 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 将使用默认设置，具体取决于所选环境。 例如，如果选择了   make   生成器，则默认值为  `-- -j <number_of_hardware_cores>` ，而对于 Microsoft Visual C++，此字段为空。      > **Tip:** > 您始终可以点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.expandComponentHover.svg) 在编辑器窗口中输入所需的选项。    |
|  环境  |     点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.inlineVariables.svg) 调出   环境变量   窗格，并在其中选择要在生成阶段传递给 CMake 的 [环境变量](cmake-profile.html#EnvVariables)。        * 使用 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.copy.svg) 和 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.paste.svg) 按钮管理自定义变量列表。    * 如果希望将指定的值附加到系统变量，请选择 包含系统环境变量 复选框链接。 否则，当复选框被清除时，您的自定义值将覆盖系统值。    |

## See also

### 外部链接

[CMake documentation](http://www.cmake.org/documentation)

### 操作指南

[教程：在 Windows 上配置 CLion](quick-tutorial-on-configuring-clion-on-windows.html)

