使用Clang 14编译Boost program_options时出现链接错误的原因？

问题场景 #

我编写了使用Boost program_options的最小化代码boost_version.cpp：

#include <boost/version.hpp>
#include <boost/program_options.hpp>
#include <iostream>

int main(int argc, char* argv[]) {
    boost::program_options::options_description desc("Allowed options");
    desc.add_options()
        ("help", "produce help message")
        ("input", boost::program_options::value<std::string>(), "input parameter");

    // parses cmd line options and stores them in a variable map
    boost::program_options::variables_map vm;
    boost::program_options::store(boost::program_options::parse_command_line(argc, argv, desc), vm);
    boost::program_options::notify(vm);

    // if the help option is set, print the help message
    if (vm.count("help")) {
        std::cout << desc << "\n";
        return 1;
    }
    // if the input option is set, print the input parameter
    if (vm.count("input")) {
        std::cout << "Input parameter was set to " << vm["input"].as<std::string>() << ".\n";
    } else {
        std::cout << "Input parameter was not set.\n";
    }

    std::cout << "Boost version: " << BOOST_VERSION / 100000 << "." 
              << BOOST_VERSION / 100 % 1000 << "." 
              << BOOST_VERSION % 100 << std::endl;

    return 0;
}

使用系统预装的Boost 1.74.0，库文件路径：

❯ locate libboost | grep boost_program_options
/usr/lib/x86_64-linux-gnu/libboost_program_options.a
/usr/lib/x86_64-linux-gnu/libboost_program_options.so
/usr/lib/x86_64-linux-gnu/libboost_program_options.so.1.74.0
/usr/lib/x86_64-linux-gnu/cmake/boost_program_options-1.74.0/libboost_program_options-variant-shared.cmake
/usr/lib/x86_64-linux-gnu/cmake/boost_program_options-1.74.0/libboost_program_options-variant-static.cmake

CMakeLists.txt配置：

cmake_minimum_required(VERSION 3.10)
project(BoostVersion)

set(CMAKE_CXX_STANDARD 20)
set(BOOST_ROOT "/usr/")
find_package(Boost 1.74.0 REQUIRED COMPONENTS program_options)
if(Boost_FOUND)
    include_directories(${Boost_INCLUDE_DIRS})
    link_directories(${Boost_LIBRARY_DIRS})
    add_executable(BoostVersion boost_version.cpp)
    target_link_libraries(BoostVersion ${Boost_LIBRARIES})
endif()


message("BOOST_ROOT: ${BOOST_ROOT}")
message("Boost_DIR: ${Boost_DIR}")
message("Boost_INCLUDE_DIR: ${Boost_INCLUDE_DIR}")
message("Boost_LIBRARY_DIRS: ${Boost_LIBRARY_DIRS}")
message("Boost_LIBRARIES: ${Boost_LIBRARIES}")

执行编译命令：

mkdir build && cd build
❯ cmake -DCMAKE_C_COMPILER=/usr/bin/clang-14 -DCMAKE_CXX_COMPILER=/usr/bin/clang++-14 -DCMAKE_CXX_FLAGS="-stdlib=libc++ -I /usr/lib/llvm-14/include/c++/v1" ..
-- The C compiler identification is Clang 14.0.0
-- The CXX compiler identification is Clang 14.0.0
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working C compiler: /usr/bin/clang-14 - skipped
-- Detecting C compile features
-- Detecting C compile features - done
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Check for working CXX compiler: /usr/bin/clang++-14 - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Found Boost: /usr/lib/x86_64-linux-gnu/cmake/Boost-1.74.0/BoostConfig.cmake (found suitable version "1.74.0", minimum required is "1.74.0") found components: program_options 
BOOST_ROOT: /usr/
Boost_DIR: /usr/lib/x86_64-linux-gnu/cmake/Boost-1.74.0
Boost_INCLUDE_DIR: /usr/include
Boost_LIBRARY_DIRS: /usr/lib/x86_64-linux-gnu
Boost_LIBRARIES: Boost::program_options
-- Configuring done
-- Generating done

执行make时出现大量未定义引用错误，部分错误信息：

❯ make
[ 50%] Building CXX object CMakeFiles/BoostVersion.dir/boost_version.cpp.o
[100%] Linking CXX executable BoostVersion
/usr/bin/ld: CMakeFiles/BoostVersion.dir/boost_version.cpp.o: in function `main':
boost_version.cpp:(.text+0x4c): undefined reference to `boost::program_options::options_description::options_description(std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char> > const&, unsigned int, unsigned int)'
/usr/bin/ld: boost_version.cpp:(.text+0x205): undefined reference to `boost::program_options::operator<<(std::__1::basic_ostream<char, std::__1::char_traits<char> >&, boost::program_options::options_description const&)'
...
clang: error: linker command failed with exit code 1 (use -v to see invocation)
make[2]: *** [CMakeFiles/BoostVersion.dir/build.make:98: BoostVersion] Error 1
make[1]: *** [CMakeFiles/Makefile2:83: CMakeFiles/BoostVersion.dir/all] Error 2
make: *** [Makefile:91: all] Error 2

错误原因分析 #

核心问题：C++标准库ABI不兼容 #

系统预装的Boost 1.74.0库是通过GCC编译的，依赖libstdc++（GNU的C标准库）；而你编译代码时指定了-stdlib=libc++，使用Clang的C标准库实现。两者的STL符号命名空间不同：

• libc++的STL类型位于std::__1命名空间（比如std::__1::basic_string）
• libstdc++的STL类型位于std命名空间（比如std::basic_string）

Boost库中的函数符号依赖libstdc的std命名空间类型，但你的代码编译后生成的调用符号依赖libc的std::__1命名空间类型，链接器无法找到匹配的符号，因此抛出大量未定义引用错误。

验证依据 #

从错误信息中的符号可以直接看出差异：错误里的未定义符号参数都是std::__1::basic_string等libc++专属类型，而系统Boost库中对应的符号参数是std::basic_string，两者无法匹配。

解决方向 #

1. 放弃libc++，使用系统默认的libstdc++：去掉编译参数中的-stdlib=libc++和对应的libc++头文件路径，让代码和预装Boost库使用相同的标准库，ABI保持一致。
2. 手动编译适配libc++的Boost库：如果必须使用libc++，需要下载Boost源码，用Clang+-stdlib=libc++参数重新编译Boost，确保Boost库的STL依赖和你的代码完全匹配，之后在CMake中指定使用自己编译的Boost库路径。

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