# CMake 性能分析

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

通过 CMake 性能分析，您可以识别项目重新加载中最耗时的操作，并在必要时优化您的 CMake 脚本。

性能分析适用于 CMake 3.18 及更高版本。 CMake 将结果存储在 Google 的 [Trace Event 格式](https://docs.google.com/document/d/1CvAClvFfyA5R-PhYUmn5OOQtYMH4h6I0nSsKchNAySU/preview)中。 CLion 的集成帮助您运行跟踪并可视化结果。

> **Note:**
> 性能分析不适用于基于 [presets](cmake-presets.html)的 CMake 配置文件。

Procedure: 启用跟踪

启用跟踪需要两个标志：  `--profiling-format=google-trace`  和  `--profiling-output=path` 。 在这些标志存在的情况下，CMake 会生成一个包含跟踪结果的 JSON 文件，并将其放置在指定路径下。

在 CLion 中，您可以使用以下选项之一来启用跟踪：

* 手动

转到  `设置 | 构建、执行、部署 | CMake`  并选择您想要跟踪的配置文件。 将标志添加到   CMake 选项  。

* 自动化

加载您想要跟踪的配置文件后，点击   向 CMake 添加事件跟踪  ，位于   CMake   工具窗口中：

![自动添加 CMake 性能分析标志](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_profiling_add_flags.png)

CLion 将创建配置文件的副本并添加所需选项。 新配置文件将具有与  -event-trace 后缀相同的名称：

![已自动添加跟踪配置文件](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_profiling_trace_profile.png)

如果已经存在跟踪配置文件，IDE 将检测到并显示通知：

![跟踪配置文件已存在](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_profiling_already_added.png)

添加性能分析标志后，CLion 将在每次项目重新加载时收集跟踪信息。 点击通知中的链接以打开结果：

![CMake 性能分析结果已准备好](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_profiling_notification.png)

> **Tip:**
> 如果您已经有一个包含跟踪结果的  `.json`  文件，您可以通过  `运行 | 打开性能分析器快照`  在 CLion 中打开它。

Procedure: 查看结果

CLion 在   分析器  工具窗口中呈现结果：

![CMake 性能分析工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_profiling_tw.png)

* 在左侧窗格中，您可以找到 CMake 重新加载过程的进程和线程 ID。

* 在中央窗格中，您可以检查进程的 [火焰图](https://www.brendangregg.com/flamegraphs.html)。 它显示了堆栈跟踪的集合：矩形代表调用堆栈的帧，按宽度排序。

> **Tip:**
> 要在火焰图中放大和缩小，请按住  `Ctrl`  并滚动鼠标滚轮，或使用 ![“缩放”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.zoomIn.svg) 和 ![缩小按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.zoomOut.svg) 按钮。

* 在右侧窗格中，您可以探索在火焰图中选择的事件的详细信息。 这些信息包括函数名称、持续时间、函数参数以及函数在 CMake 脚本中的位置。

您还可以将鼠标悬停在一个块上以显示包含事件详情的工具提示：

![事件详情工具提示](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_profiling_tooltip.png)

> **Tip:**
> 点击   位置   链接跳转到相应的行。

## See also

### 操作指南

[快速 CMake 教程](quick-cmake-tutorial.html) [CMakeLists.txt](cmakelists-txt-file.html) [加载/重新加载 CMake](reloading-project.html)

