CMake函数如何访问定义作用域变量且不污染父作用域

核心原因 #

• CMake本身不支持闭包特性，函数执行时的变量查找逻辑是：先查函数自身的局部作用域，再逐层向上查找函数调用链的作用域，而非函数定义时的作用域。
• add_subdirectory会为子项目创建独立的作用域，子项目中通过普通set定义的变量，会在子项目执行完成、回到父项目作用域时被销毁，父作用域默认无法访问，函数在父作用域调用时自然也找不到该变量。
• 你看到的官方示例和你的场景本质不同：官方示例中的代码通常写在独立的CMake模块中，通过include()加载，include()不会创建新作用域，模块中定义的变量会直接存在于调用include()的作用域中，属于全局可见的变量，因此函数执行时可以正常读取。
• 额外说明：你看到的官方示例中_THIS_MODULE_BASE_DIR的写法是旧版本CMake的兼容方案，CMake 3.18及以上版本提供了内置变量CMAKE_CURRENT_FUNCTION_LIST_DIR，可以直接在函数内获取函数定义所在的CMake脚本目录，不需要手动定义变量。

不污染父作用域的解决方案 #

你不需要用PARENT_SCOPE，可以选择以下任意一种方案实现需求：

方案1：使用内部缓存变量 #

将变量设为INTERNAL类型的缓存变量，不会污染普通父作用域的变量空间，父项目中直接读取${V}仍然是空值：

# 子项目CMakeLists.txt中修改set语句
set(V "hello" CACHE INTERNAL "Internal variable for test function")

方案2：将变量值内嵌到函数定义中 #

通过配置生成的方式，把变量值直接写入函数体，不需要依赖外部变量：

1. 子项目中创建test_func.cmake.in文件：

function(test)
    message("function scope: @V@")
endfunction()

2. 子项目CMakeLists.txt中添加配置逻辑：

set(V "hello")
configure_file(test_func.cmake.in ${CMAKE_CURRENT_BINARY_DIR}/test_func.cmake @ONLY)
include(${CMAKE_CURRENT_BINARY_DIR}/test_func.cmake)

方案3：使用函数属性存储变量（CMake 3.19+支持） #

直接把变量作为自定义属性绑定到函数上，完全不暴露到全局作用域：

# 子项目CMakeLists.txt
set(V "hello")
function(test)
  get_property(V FUNCTION test PROPERTY _V)
  message("function scope: ${V}")
endfunction()
set_property(FUNCTION test PROPERTY _V "${V}")

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