CMake+Conan编译C++程序时Boost Filesystem版本错误排查

我正在开发一个使用CMake与Conan编译、基于Boost 1.74的C++程序，近期突然出现错误：

error: #error Compiling Filesystem version 3 file with BOOST_FILESYSTEM_VERSION defined != 3

此前程序运行正常。

以下是我的CMake代码：

#使用Conan查找外部库
----------------------------------------------------------
conan_check(VERSION 1.0.0 REQUIRED)
message(STATUS "下载依赖库中，使用Conan")

#Boost依赖配置较为特殊
#需要1.74版本以保证行为正确，且需配置选项以在Mac上成功构建
if("${CMAKE_SYSTEM_NAME}" STREQUAL "Darwin")
     #针对https://github.com/conan-io/conan-center-index/issues/4097的临时解决方案
    set(CONAN_OPTIONS boost:without_fiber=True boost:without_nowide=True)
else()
    set(CONAN_OPTIONS )
endif()

conan_cmake_run(REQUIRES boost/1.74.0 jsoncpp/[>=1.8.4] eigen/[>=3.3.7] cgal/[>=5.1]
    OPTIONS
        ${CONAN_OPTIONS}
    BUILD missing
    CMAKE_TARGETS
    BASIC_SETUP
    UPDATE)

我认为Boost 1.74仅支持Filesystem v3，请问如何检查当前Boost Filesystem版本？希望得到可行的修复方案。

一、检查当前Boost Filesystem版本 #

• 代码检测法：在测试代码中添加以下内容，编译运行后即可查看版本信息：

#include <iostream>
#include <boost/filesystem.hpp>

int main() {
    #ifdef BOOST_FILESYSTEM_VERSION
    std::cout << "当前定义的BOOST_FILESYSTEM_VERSION: " << BOOST_FILESYSTEM_VERSION << std::endl;
    #endif
    std::cout << "Boost Filesystem默认支持版本: " << BOOST_FILESYSTEM3_VERSION << std::endl;
    return 0;
}

• 编译日志排查：开启CMake verbose模式（添加-DCMAKE_VERBOSE_MAKEFILE=ON参数重新配置），查看编译命令中是否存在手动指定BOOST_FILESYSTEM_VERSION的宏定义（如-DBOOST_FILESYSTEM_VERSION=2）。

二、修复方案 #

错误根源是存在与v3不匹配的BOOST_FILESYSTEM_VERSION宏定义，Boost 1.74确实仅支持Filesystem v3（v2已被移除），可按以下步骤修复：

1. 清理代码中的宏定义：全局搜索项目代码，找到所有#define BOOST_FILESYSTEM_VERSION语句，要么删除，要么修改为#define BOOST_FILESYSTEM_VERSION 3。
2. 检查CMake配置：
   • 确认是否通过target_compile_definitions给目标添加了该宏
   • 排查Conan配置（包括profile文件）中是否有强制设置该宏的选项
3. 清理缓存重新构建：删除CMake构建目录（通常是build文件夹），执行conan remove boost/1.74.0 -f清理Conan本地缓存，然后重新执行CMake配置和编译流程。
4. 覆盖依赖传递的宏：如果是CGAL等依赖库间接设置了不匹配的版本，可通过CMake命令查看并覆盖：

   # 查看Boost filesystem目标的编译宏
   get_target_property(BOOST_FS_DEFS Boost::filesystem COMPILE_DEFINITIONS)
   message(STATUS "Boost Filesystem编译宏: ${BOOST_FS_DEFS}")
   
   # 强制给你的目标设置正确版本
   target_compile_definitions(你的项目目标名 PRIVATE BOOST_FILESYSTEM_VERSION=3)
   

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