CMake构建C++项目：Boost::filesystem与CMP0167相关问题排查

一、"Bad"版CMake配置失败原因分析 #

报错无法找到Boost::filesystem目标，核心问题在于未在find_package中明确指定需要的Boost组件：

典型的"Bad"配置示例：

find_package(Boost REQUIRED)
add_executable(mytool main.cpp)
target_link_libraries(mytool Boost::filesystem)

问题细节：

• 当find_package(Boost)不添加COMPONENTS filesystem参数时，CMake的FindBoost模块仅会检查Boost头文件是否存在，不会去查找并加载filesystem对应的库文件，因此不会生成Boost::filesystem这个导入目标。
• 即使系统中已安装Boost.Filesystem库，CMake也无法识别到该组件，自然会抛出目标不存在的错误。

而"Good"和"Modified"版本通常会正确添加组件声明，比如：

find_package(Boost REQUIRED COMPONENTS filesystem)

这样FindBoost模块会主动查找filesystem库，并生成对应的Boost::filesystem目标供链接使用。

二、Msys2中Boost库带"-mt"后缀的原因 #

"-mt"是**multi-threaded（多线程）**的缩写，原因如下：

• Msys2环境下的Boost默认以多线程安全模式编译，该后缀用于标识库是针对多线程场景构建的。
• Windows平台的C/C运行时需要区分单线程和多线程版本（比如MinGW的libstdc、MSVC的MSVCRT），带"-mt"的Boost库会链接多线程版本的运行时，确保在多线程程序中能正确工作。
• 对比Linux平台，由于系统运行时默认支持多线程，Boost库的命名不会显式添加"-mt"后缀，但本质上也是多线程安全的；而Windows平台必须通过后缀明确区分，避免链接错误。

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