CLion 2025.2 Help

CMake

使用此页面配置当前项目的 CMake 配置文件设置。

CMake 设置对话框

描述

在编辑 CMakeLists.txt 或其他 CMake 配置文件时重新加载 CMake 项目

如果选中此复选框,CLion 会在您编辑 CMakeLists.txtCMakePresets.json 时自动重新加载您的项目。

如果清除此复选框,CLion 会显示一个弹出消息,您可以选择手动重新加载当前项目或启用自动重新加载(这将导致选中此复选框):

CMake 重新加载选项

但是,如果发生了一些外部更改(例如,从版本控制中更新),项目仍会重新加载。

配置文件

项目

描述

配置文件

在此字段中,选择一个 CMake 配置文件。 您可以在此处编辑、删除或添加配置文件。

  • 点击 按钮将配置文件添加到列表中。 默认情况下,配置文件的命名基于当前选择的构建类型和工具链。

  • 点击 按钮从列表中删除选定的配置文件。

  • 点击 按钮创建选定配置文件的副本。

注意 :此 CMake 配置文件列表决定了 运行/调试配置切换器和 解析上下文列表中可用的配置文件。

启用配置文件

如果您禁用某个配置文件,它将不会包含在 CMake 重新加载中。 使用此选项禁用您当前不需要的配置文件。

名称

此字段表示选定配置文件的名称。

构建类型

从此下拉列表中选择所需的 构建类型

默认情况下,如果此字段未手动设置,类型为 Debug

请注意, 默认 选项对应于 CMAKE_构建_TYPE 的空值。

工具链

从此下拉列表中选择所需的工具链。 此列表由您在工具链设置对话框中创建的工具链组成。

如果未选择任何内容,则 CLion 使用当前设置为默认值的 工具链 (工具链列表中的第一个)。

生成器

在此处,您可以选择 CMake 生成器

生成器下拉菜单

或者,您可以通过 CMake 选项 设置生成器。 CLion 会相应地更新这两个字段。

CMake 选项

在此字段中,指定额外的 CMake 选项 ,用空格分隔。

例如,您可以通过 -G 在此处指定自定义 CMake 生成器

您还可以通过点击 在此字段中插入项目路径宏:

CMake 选项宏

构建目录

在此处指定生成的 CMake 文件的所需位置。 此路径可以是绝对路径(例如, c:\CLion_Projects\My_Project\cmake-构建-debug )或相对于当前项目根目录的相对路径(例如, cmake-构建-debug )。

将此字段留空以使用默认位置,即项目根目录下的 cmake-构建-[buid_type]

此设置保存在 .idea/workspace.xml 中,不应共享。

构建选项

在此字段中,指定要传递给 CMake 使用的构建工具或作为命令行参数传递给 CMake 的选项。

此字段中的选项会在构建阶段传递给 CMake(有关更多信息,请参阅 CMake 构建 命令的描述)。

要传递给底层构建工具(如 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++,此字段为空。

环境

点击 调出 环境变量 面板,并在其中选择要在生成阶段传递给 CMake 的 环境变量

  • 使用 按钮管理自定义变量列表。

  • 如果您希望指定的值附加到系统变量中,请选择 包含系统环境变量 复选框链接。 否则,当复选框被清除时,您的自定义值将覆盖系统值。

最后修改日期: 2025年 9月 26日