使用静态Qt库创建QString时出现未解析外部符号错误求助

你遇到的问题是自行编译静态Qt库后，创建QString对象时出现QArrayData::deallocate和QArrayData::shared_null未解析外部符号错误，即便dumpbin确认符号存在于Qt5Core.lib中。以下是针对性的解决办法：

• 严格匹配编译环境参数
  确保你的项目与编译Qt库时的环境完全一致：

  • MSVC编译器版本（如VS2019/VS2022）、平台位数（x86/x64）必须完全相同；
  • 调试/发布模式对应：调试模式下必须链接Qt5Cored.lib，发布模式链接Qt5Core.lib，不可混用；
  • 编译选项（如C++标准版本）也要保持一致，否则符号修饰规则会出现差异，导致链接时无法匹配。

• 检查预定义宏设置
  在项目的预处理器定义中添加以下宏（根据编译模式调整）：

  • 通用静态编译宏：QT_STATIC_BUILD；
  • 调试模式额外添加：QT_DEBUG；
  • 发布模式额外添加：QT_NO_DEBUG；
    这些宏会影响Qt头文件中函数的声明方式，必须与编译Qt库时的宏定义一致，否则会出现声明与库中符号不匹配的情况。

• 确认Qt库编译配置
  检查编译Qt时的配置参数：

  • 确保编译时使用了-static参数启用静态编译；
  • 查看config.log文件，确认未通过-no-feature-xxx禁用QArrayData相关的核心功能；
  • 若编译时指定了特殊平台参数（如-platform win32-msvc2019），项目的平台工具集也要对应设置。

• 调整链接顺序与依赖项

  • 在项目的「附加依赖项」中，确保Qt5Core.lib（或Qt5Cored.lib）被正确添加，且路径指向你自行编译的静态库文件；
  • Qt静态库的链接有依赖顺序要求，Core库需放在最前面，若后续用到其他Qt模块，也要按依赖顺序添加（如Gui依赖Core）。

• 清理重建项目
  旧的编译缓存可能导致符号匹配异常，执行以下操作：

  • 删除项目的Debug/Release编译目录；
  • 清理VS解决方案（菜单→项目→清理）；
  • 重新生成解决方案。

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