VS2017主项目链接静态库出现std::string未定义符号报错

• STL实现不兼容：报错中出现的std::string::_Rep::_M_destroy、std::string::_Rep::_S_empty_rep_storage是GCC libstdc的专属内部符号，MSVC自带的STL实现无对应函数定义。若待链接静态库为Clang/GCC搭配libstdc构建，与VS2017默认的MSVC STL属于完全不兼容的两套实现，跨库传递std::string类型时必然出现符号匹配失败。
• ABI版本不匹配：即便静态库为GCC构建，若其构建时的_GLIBCXX_USE_CXX11_ABI宏开关、GCC版本与主项目Gnu++14标准对应的运行时不匹配，也会导致std::basic_string的符号修饰规则、内存布局出现差异，触发undefined symbol报错。
• 编译配置不统一：若静态库与主项目的运行时库链接选项（/MD动态链接运行时/MT静态链接运行时）、Debug/Release构建配置、C++标准版本不一致，也会引发STL相关符号找不到的问题。

• 静态库身份校验：执行dumpbin /exports <静态库文件路径>查看库内导出的符号列表，若存在libstdc++专属内部符号，可直接判定该库非MSVC构建，无法直接接入VS2017的MSVC编译链路。
• 针对GCC/Clang构建的libstdc++静态库：
  • 对齐工具链版本：将主项目编译环境切换为与静态库构建时完全同版本的GCC/Clang工具链，保证C++标准版本、_GLIBCXX_USE_CXX11_ABI开关、运行时链接选项完全一致。
  • 接口隔离改造：将静态库的跨边界接口全部改为纯C类型，不向外暴露任何std::string等C标准库类型，在库内部完成C类型与char*的转换，再将封装后的适配层编译为可跨编译器链接的静态库，接入主项目。
• 针对MSVC构建的同编译器静态库：
  • 对齐所有编译参数：统一主项目与静态库的C++标准版本、运行时库链接选项、构建配置（Debug/Release），禁止将Debug版静态库链接到Release主项目中。
  • 排查会改变STL ABI的编译开关，比如关闭不匹配的/Zc:char8_t选项、修正错误的/std:c++参数配置。

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