为CMake查找模块添加包装，消除Boost重复导入目标警告

我之前也碰到过一模一样的糟心事——旧版本CMake搭配Boost时，每次针对不同组件调用find_package(Boost COMPONENTS ...)，都会弹出"Imported targets not available"的警告，日志里堆得乱糟糟的。既然没法强制用户升级CMake，也找不到直接让警告只显示一次的开关，用包装函数确实是最靠谱的折中方案。下面是我验证过的可行方法：

自定义包装函数替代原生find_package(Boost) #

在项目根目录的CMakeLists.txt开头（或者单独的cmake模块文件里），添加这个自定义函数：

function(find_package_Boost)
  # 全局标记：记录Boost是否已经完成首次查找初始化
  if(NOT DEFINED _Boost_FIND_PACKAGE_INITIALIZED)
    # 第一次调用：正常执行原生find_package，保留首次警告（无法完全避免，但只出现一次）
    find_package(Boost ${ARGV})
    # 设置全局标记，后续调用不再触发警告输出
    set(_Boost_FIND_PACKAGE_INITIALIZED TRUE CACHE INTERNAL "Flag to track Boost find_package initialization")
  else()
    # 后续调用：临时抑制WARNING级别的日志，避免重复警告
    # 先保存当前日志级别，避免影响其他逻辑
    set(_OLD_MESSAGE_LOG_LEVEL "${CMAKE_MESSAGE_LOG_LEVEL}")
    # 将日志级别临时提升至ERROR，过滤掉WARNING输出
    set(CMAKE_MESSAGE_LOG_LEVEL ERROR)
    
    # 执行原生find_package，传递所有传入的参数
    find_package(Boost ${ARGV})
    
    # 恢复原来的日志级别
    set(CMAKE_MESSAGE_LOG_LEVEL "${_OLD_MESSAGE_LOG_LEVEL}" CACHE STRING "CMake message log level" FORCE)
  endif()
endfunction()

使用方法 #

把项目中所有原来调用find_package(Boost ...)的地方，替换成find_package_Boost(...)即可。比如原来的：

find_package(Boost COMPONENTS filesystem REQUIRED)

改成：

find_package_Boost COMPONENTS filesystem REQUIRED)

为什么这个方法有效？ #

• 首次调用时，会正常执行原生查找逻辑，只输出一次警告（这是旧版本CMake-Boost模块的固有行为，没法完全消除，但至少不会重复出现）
• 后续调用时，我们临时将CMake的日志级别提升到ERROR，过滤掉所有WARNING级别的输出——既解决了Boost的重复警告问题，又不会影响ERROR级别的关键错误信息
• 函数通过${ARGV}传递所有参数，完全兼容原生find_package(Boost)的所有用法（比如指定版本、组件、REQUIRED选项等）
• 不需要强制用户升级CMake，所有语法都是CMake基础特性，兼容旧版本环境

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