CMake配置Boost静态库却仍依赖动态库的问题排查

你遇到的情况挺典型的——明明开了静态链接的开关，结果还是绑上了动态库，核心问题出在你的CMake配置没有正确触发Boost静态库的查找逻辑，而且链接方式也不符合CMake的规范。下面我拆解一下问题点和修复方案：

1. 最关键的缺失：没调用find_package(Boost) #

你只设置了Boost_USE_STATIC_LIBS这类开关变量，但没让CMake去实际查找并加载Boost库的配置信息。这就导致${Boost_INCLUDE_DIR}和${Boost_LIBRARY_DIRS}其实是空的，你写的include_directories和link_directories等于没生效。CMake在这种情况下，会默认去系统标准路径搜boost_system、boost_regex，而系统里通常优先放动态库，自然就链接了.so文件。

2. target_link_libraries的写法不规范 #

直接写boost_system boost_regex这种裸库名，CMake会按默认规则（优先动态库）去搜索。正确的做法是用CMake通过find_package找到的导入目标或变量，这样才能精准链接到静态库。

3. 对Boost_USE_STATIC_RUNTIME的误解 #

这个变量控制的是Boost库自身链接的C/C++运行时库是静态还是动态，不是控制你的项目链接Boost的方式。除非你需要Boost静态绑定运行时，否则这个开关可以按需调整，但它不是当前问题的诱因。

正确的CMake配置示例 #

# 启用Boost静态库链接
set(Boost_USE_STATIC_LIBS ON)
set(Boost_USE_MULTITHREADED ON)
# 若需要Boost静态链接C++运行时再打开，否则可注释
# set(Boost_USE_STATIC_RUNTIME ON)

# 关键步骤：查找Boost库，指定你需要的组件（system、regex）
find_package(Boost REQUIRED COMPONENTS system regex)

# 假设你的项目目标名为my_target
add_executable(my_target your_source_files.cpp)

# 方式1：用CMake生成的Boost_LIBRARIES变量
target_link_libraries(my_target PRIVATE ${Boost_LIBRARIES})

# 方式2：现代CMake推荐的导入目标（更清晰，支持属性自动传递）
# target_link_libraries(my_target PRIVATE Boost::system Boost::regex)

额外验证步骤 #

• 运行CMake时看输出日志，如果出现Found Boost: /path/to/boost (found version "1.62.0") found components: system regex，且标注了静态库路径（比如/path/to/boost/lib/libboost_system.a），说明查找正常。
• 编译时用cmake --build . --verbose查看链接命令，确认链接的是.a后缀的静态库，而非.so。
• 检查Boost安装目录下是否有静态库文件（.a），如果只有动态库（.so），那CMake也没法静态链接——这种情况需要重新编译Boost生成静态库。

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