CMake引入Boost报错：为何已存在同名Boost::headers别名目标？

错误原因 #

你在配置中同时混用了FetchContent_Declare的FIND_PACKAGE_ARGS参数和直接指定Boost源码包下载的设置，再加上BOOST_ENABLE_CMAKE ON的开启，导致目标冲突：

• FIND_PACKAGE_ARGS会让CMake先尝试调用find_package(Boost)查找系统中已安装的Boost，这个过程可能生成Boost::headers别名目标；
• 当系统找不到Boost时，FetchContent会下载你指定的Boost源码包，而Boost自身的CMake配置（开启BOOST_ENABLE_CMAKE后）会再次尝试创建Boost::headers别名目标，两者重复触发报错。

修正方案 #

方案1：强制使用指定版本的Boost（推荐） #

如果你明确要使用你指定URL的Boost 1.83.0版本，直接移除FIND_PACKAGE_ARGS参数即可，避免触发系统的FindBoost模块：

cmake_minimum_required(VERSION 3.28)

set(BOOST_INCLUDE_LIBRARIES filesystem iostreams log program_options system)
set(BOOST_ENABLE_CMAKE ON)
include(FetchContent)
FetchContent_Declare(
    Boost
    URL https://github.com/boostorg/boost/releases/download/boost-1.83.0/boost-1.83.0.7z
    USES_TERMINAL_DOWNLOAD TRUE
    DOWNLOAD_NO_EXTRACT FALSE
)
FetchContent_MakeAvailable(Boost)

方案2：优先使用系统Boost，找不到再下载 #

如果希望优先使用系统已安装的Boost，需要调整配置避免冲突，比如关闭BOOST_ENABLE_CMAKE（改用Boost传统配置方式），确保只让一方负责创建Boost::headers目标：

cmake_minimum_required(VERSION 3.28)

set(BOOST_INCLUDE_LIBRARIES filesystem iostreams log program_options system)
include(FetchContent)
FetchContent_Declare(
    Boost
    URL https://github.com/boostorg/boost/releases/download/boost-1.83.0/boost-1.83.0.7z
    USES_TERMINAL_DOWNLOAD TRUE
    DOWNLOAD_NO_EXTRACT FALSE
    FIND_PACKAGE_ARGS COMPONENTS ${BOOST_INCLUDE_LIBRARIES}
)
FetchContent_MakeAvailable(Boost)

（注：此方案下，系统Boost会优先被使用，只有当系统找不到对应组件时才会下载指定版本）

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