CMake中FetchContent_MakeAvailable未填充Boost相关变量问题

在项目中使用FetchContent添加Boost作为外部项目依赖，设置了BOOST_INCLUDE_LIBRARIES、BOOST_ENABLE_CMAKE等参数，通过FetchContent_Declare指定了Boost的本地目录与远程URL，执行FetchContent_MakeAvailable后，尝试打印所有以BOOST开头的变量但无任何输出。请问我的CMake代码是否缺少必要语句？

对应的CMake代码如下：

include(FetchContent)

set(BOOST_INCLUDE_LIBRARIES math filesystem system program_options asio)
set(BOOST_ENABLE_CMAKE ON)

FetchContent_Declare(
    Boost
    SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/src/boost
    URL https://boostorg.jfrog.io/artifactory/main/release/1.74.0/source/boost_1_74_0.tar.gz
)
FetchContent_MakeAvailable(Boost)


get_cmake_property(_variableNames VARIABLES)
list (SORT _variableNames)
foreach (_variableName ${_variableNames})
    string(FIND "${_variableName}" "BOOST" out)
    if ("${out}" EQUAL 0)
        message(STATUS "vriables => ${_variableName}=${${_variableName}}")
    endif()
endforeach()

核心原因是CMake的变量作用域限制：FetchContent_MakeAvailable会将Boost的构建流程隔离在子目录中，子项目内定义的BOOST_*变量默认不会暴露到主项目的全局作用域。另外你设置的BOOST_INCLUDE_LIBRARIES等是Boost配置的输入变量，这些变量仅在子项目初始化时生效，不会在主项目全局保留。

修正方案与代码调整 #

你不需要强行获取BOOST_*变量，因为开启BOOST_ENABLE_CMAKE后，Boost会自动生成Boost::<library>形式的CMake目标，直接使用这些目标即可完成链接和包含目录配置。如果确实需要查看相关属性，可以通过以下方式：

include(FetchContent)

set(BOOST_INCLUDE_LIBRARIES math filesystem system program_options asio)
set(BOOST_ENABLE_CMAKE ON)

FetchContent_Declare(
    Boost
    SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/src/boost
    URL https://boostorg.jfrog.io/artifactory/main/release/1.74.0/source/boost_1_74_0.tar.gz
)
FetchContent_MakeAvailable(Boost)

# 1. 直接使用Boost生成的目标（推荐方式）
message(STATUS "可用Boost目标：Boost::math, Boost::filesystem, Boost::system等")

# 2. 获取Boost项目的基础属性
FetchContent_GetProperties(Boost)
message(STATUS "Boost源码目录：${Boost_SOURCE_DIR}")
message(STATUS "Boost构建目录：${Boost_BINARY_DIR}")

# 3. 获取特定库的包含目录（通过目标属性）
get_target_property(Boost_Math_Include_Dir Boost::math INTERFACE_INCLUDE_DIRECTORIES)
message(STATUS "Boost Math包含目录：${Boost_Math_Include_Dir}")

# 4. 尝试打印全局作用域的BOOST变量
get_cmake_property(_variableNames VARIABLES)
list(SORT _variableNames)
foreach(_variableName ${_variableNames})
    string(FIND "${_variableName}" "BOOST" out)
    if("${out}" EQUAL 0)
        message(STATUS "全局变量 => ${_variableName}=${${_variableName}}")
    endif()
endforeach()

# 5. 查看Boost子项目内的BOOST变量
message(STATUS "---------- Boost子项目内的变量 ----------")
set(_boost_sub_dir ${Boost_BINARY_DIR})
if(EXISTS ${_boost_sub_dir})
    get_directory_property(_sub_vars VARIABLES DIRECTORY ${_boost_sub_dir})
    list(SORT _sub_vars)
    foreach(_var ${_sub_vars})
        string(FIND "${_var}" "BOOST" out)
        if("${out}" EQUAL 0)
            get_directory_property(_var_val DIRECTORY ${_boost_sub_dir} DEFINITION ${_var})
            message(STATUS "子项目变量 => ${_var}=${_var_val}")
        endif()
    endforeach()
endif()

关键说明 #

• 开启BOOST_ENABLE_CMAKE后，Boost会以CMake原生目标形式提供依赖，直接链接Boost::<library>即可，无需手动处理包含目录和库文件路径。
• FetchContent_GetProperties是获取外部项目基础信息的标准方式，能拿到源码目录、构建目录等核心路径。
• 子项目的变量需要通过DIRECTORY参数指定子目录才能获取，不建议直接依赖这些变量，优先使用官方提供的CMake目标。

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