CMake缓存性能优化的使用惯用法及缓存变量写法正确性验证

一、提升性能的CMake缓存使用惯用法 #

• 缓存耗时操作结果：对于find_package、find_path这类需要遍历系统路径、调用外部工具的耗时操作，将结果存入缓存，后续构建直接复用，避免重复执行。
• 明确缓存变量类型与描述：给缓存变量指定FILEPATH、STRING、BOOL等类型，加上清晰的描述文本。这样CMake会自动校验值的合法性，也方便用户通过配置界面修改，减少因无效值导致的重复计算。
• 用INTERNAL类型存储内部值：如果某个值仅用于CMake内部逻辑，不需要用户修改，设置CACHE INTERNAL。既缓存结果，又不会暴露到配置界面，避免误修改引发的重新计算。
• 减少缓存变量的频繁修改：缓存变量的读写开销比普通变量高，尽量一次计算完成后存入缓存，不要在脚本中反复更新缓存值。
• 统一管理缓存目录：通过CMAKE_CACHEFILE_DIR指定固定的缓存目录，避免不同构建目录的缓存冲突，同时方便清理无效缓存，提升构建稳定性。

二、你的代码正确性分析 #

你提供的代码存在语法错误，无法实现“仅当变量未被缓存时才获取值并缓存”的逻辑，具体问题和修正方案如下：

问题点 #

原代码中$CACHE{PATH_CACHED}的写法不符合CMake语法，正确的缓存变量访问方式是${CACHE{PATH_CACHED}}；此外，直接判断变量值为空不够严谨，应该优先判断缓存变量是否未被定义，避免变量已被缓存但值为空的情况。

修正后的正确惯用法 #

如果要判断缓存变量是否未定义，从而执行初始化逻辑，推荐写法：

IF(NOT DEFINED PATH_CACHED)
  # 发现PATH_CACHED的值并存储到PATH_NORMAL
  SET(PATH_CACHED ${PATH_NORMAL} CACHE FILEPATH "My path")
ENDIF()

如果需要判断缓存变量的值是否为空（已定义但无有效值），可以用：

IF(NOT "${CACHE{PATH_CACHED}}" STREQUAL "")
  SET(PATH_CACHED ${PATH_NORMAL} CACHE FILEPATH "My path")
ENDIF()

补充说明 #

CMake中，直接使用${PATH_CACHED}会优先读取同名的普通变量，若普通变量不存在才会读取缓存变量。如果要明确只访问缓存中的值，必须用${CACHE{PATH_CACHED}}语法。

内容的提问来源于stack exchange，提问作者VladG