如何在Find<package>.cmake中创建/修改非<PACKAGE>_前缀全局变量？

核心问题分析 #

你遇到的本质是CMake变量作用域的限制：直接set的变量仅存在于当前Find模块的局部作用域，PARENT_SCOPE只能传递到直接父作用域（无法跨多层模块），而未正确配置的CACHE变量可能因未强制更新或类型缺失导致不生效。

解决方案一：使用INTERNAL类型缓存变量 #

这是最常用的全局共享方式，缓存变量会在整个CMake构建过程中全局可见，且能被后续模块更新。

示例代码（FindMyModule.cmake） #

# 初始化全局缓存变量（仅当变量未存在时执行）
if(NOT LIBS_INCLUDE_DIRS)
    set(LIBS_INCLUDE_DIRS "" CACHE INTERNAL "汇总所有依赖库的头文件路径")
endif()

# 追加当前模块的头文件路径到全局变量，FORCE确保每次调用都更新缓存
set(LIBS_INCLUDE_DIRS "${LIBS_INCLUDE_DIRS} ${MyModule_include_dirs}" CACHE INTERNAL "汇总所有依赖库的头文件路径" FORCE)

# 保留原有的模块前缀变量（符合Find模块规范）
set(MyModule_include_dirs "..." CACHE PATH "MyModule的头文件路径")

全局CMakeLists.txt调用验证 #

find_package(MyModule)
message("My Module include dirs: ${MyModule_include_dirs}")
message("Libs include dirs: ${LIBS_INCLUDE_DIRS}")

解决方案二：使用全局属性（PROPERTY） #

如果担心缓存变量与普通变量冲突，可以使用CMake的全局属性机制，属性不会直接暴露为变量，需通过get_property获取。

示例代码（FindMyModule.cmake） #

# 获取已有的全局属性值
get_property(EXISTING_LIBS_INCLUDE_DIRS GLOBAL PROPERTY LIBS_INCLUDE_DIRS)

# 初始化或追加路径
if(NOT EXISTING_LIBS_INCLUDE_DIRS)
    set_property(GLOBAL PROPERTY LIBS_INCLUDE_DIRS "${MyModule_include_dirs}")
else()
    set_property(GLOBAL PROPERTY LIBS_INCLUDE_DIRS "${EXISTING_LIBS_INCLUDE_DIRS} ${MyModule_include_dirs}")
endif()

全局CMakeLists.txt调用验证 #

find_package(MyModule)
# 从全局属性中读取值
get_property(LIBS_INCLUDE_DIRS GLOBAL PROPERTY LIBS_INCLUDE_DIRS)
message("Libs include dirs: ${LIBS_INCLUDE_DIRS}")

常见错误排查 #

• 未加FORCE关键字：缓存变量一旦设置后默认不会被覆盖，追加路径时必须用FORCE强制更新。
• 误用PARENT_SCOPE：该选项仅能将变量传递到直接调用当前模块的父作用域，若Find模块内部还有嵌套的include或find_package，无法实现全局共享。
• 缓存变量类型错误：INTERNAL类型的缓存变量适合存储内部构建信息，无需对外暴露；若需要用户可见，可改用STRING或PATH类型，但需注意权限控制。

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