# CLion IDE 的 CMake 宏

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

在某些情况下，您可能希望 CMake 脚本检测它是从 CLion 调用的还是从其他实例（如控制台）调用的。 为此，请使用特殊的环境变量  `CLION_IDE` 。 此变量是跨平台的，仅当从 CLion 调用 CMake 生成或构建时才会  `TRUE` 。

> **Tip:**
> 还有一个预处理器宏  `__CLION_IDE__` ，可帮助避免在解析某些复杂的预处理器代码块时导致 IDE 冻结。 使用此宏，您可以从代码中消除此类问题定义或包含，并用虚拟定义替换它们。
>
>
>
> `__CLION_IDE__`  宏仅影响解析。

使用  `CLION_IDE` 变量，您可以设置特定路径（例如，自定义构建目录）、执行额外的脚本或添加额外的日志记录。

将此变量放入您的 CMake 代码中很简单，因为  `CMakeLists.txt` 文件支持环境变量补全功能：

![cmake 文件中环境变量的代码补全](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakeinvoke_completion.png)

## See also

### 操作指南

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

