CMake中如何为不同第三方库/子目录隔离变量作用域？

1. 先设置BUILD_TESTS再执行add_subdirectory能否确保各自生效？ #

大部分场景下可以生效，但要注意缓存变量的坑：

• 如果第三方库的BUILD_TESTS是普通变量（仅用set()定义，未添加CACHE属性），那么在add_subdirectory前设置的值会被子目录读取，切换不同值后添加下一个子目录，能分别控制两个库的测试构建。
• 如果第三方库把BUILD_TESTS设为缓存变量（用option()或set(XXX CACHE ...)定义），第一次设置后值会存入CMake缓存，后续修改除非加FORCE参数（如set(BUILD_TESTS OFF CACHE BOOL "" FORCE)），否则不会生效。但FORCE会破坏缓存的预期行为，不建议频繁使用。

2. 更安全明确的变量隔离方法 #

推荐两种可靠方案：

• 临时保存+恢复变量值：每次添加子目录前，保存当前BUILD_TESTS的旧值，设置目标值，执行add_subdirectory后再恢复旧值，避免影响后续逻辑：

  # 处理libA，开启测试
  set(OLD_BUILD_TESTS ${BUILD_TESTS})
  set(BUILD_TESTS ON)
  add_subdirectory(libA)
  set(BUILD_TESTS ${OLD_BUILD_TESTS})
  
  # 处理libB，关闭测试
  set(OLD_BUILD_TESTS ${BUILD_TESTS})
  set(BUILD_TESTS OFF)
  add_subdirectory(libB)
  set(BUILD_TESTS ${OLD_BUILD_TESTS})
  

• 使用ExternalProject_Add构建独立进程：ExternalProject_Add会为每个第三方库启动单独的CMake构建进程，变量完全隔离，不会互相干扰，适合对构建环境隔离要求高的场景：

  include(ExternalProject)
  
  # 构建libA，开启测试
  ExternalProject_Add(
      libA
      SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/libA
      CMAKE_ARGS -DBUILD_TESTS=ON
  )
  
  # 构建libB，关闭测试
  ExternalProject_Add(
      libB
      SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/libB
      CMAKE_ARGS -DBUILD_TESTS=OFF
  )
  

3. 变量设置思路是否符合CMake常规做法？ #

你临时切换变量值的思路属于CMake社区里常见的权宜解决方案，但并非现代CMake的推荐规范。现代CMake更提倡第三方库使用前缀式命名变量（如LibA_BUILD_TESTS、LibB_BUILD_TESTS）来避免命名冲突，这是当前的标准做法。如果第三方库未遵循该规范，临时切换变量是可行的 workaround，但要注意缓存变量带来的状态问题。

为什么目录属性、目标属性无效？ #

目录属性和目标属性是CMake针对特定目录或目标的元数据，第三方库的CMakeLists通常只会读取全局变量或缓存变量，不会主动读取目录/目标属性，因此这些方法无法影响第三方库的构建逻辑。

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