添加core5compat后Qt5项目仍无法在Qt6.6编译，报未定义引用

问题背景 #

将Ubuntu更新故障后的计算机重装为Debian 12，安装Qt Creator与Qt6.6后，打开原Qt5（推测为5.15）环境下可正常运行的旧项目，使用qmake构建时出现数百个QByteArray、QDateTime、QString等核心库的未定义引用错误。已尝试以下操作但无效：

• 通过Qt管理器下载Qt5兼容模块
• 在.pro文件中添加QT += core5compat
• 添加/移除DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x050F00
• 切换C11/C17编译标准

典型错误信息 #

:-1: error: /home/pathToProjects/ScarTest/../build/simbaLib/Desktop/Debug/libsimbaLib.a(crc8message.o): in function `CRC8Message::basecmd()':
/home/pathToProjects/simbaLib/crc8message.cpp:11: error: undefined reference to `QByteArray::QByteArray(char const*, int)'
:-1: error: /home/pathToProjects/ScarTest/../build/simbaLib/Desktop/Debug/libsimbaLib.a(crc8message.o): in function `QArrayData::sharedNull()':
/usr/include/x86_64-linux-gnu/qt5/QtCore/qarraydata.h:122: error: undefined reference to `QArrayData::shared_null'
:-1: error: /home/pathToProjects/ScarTest/../build/simbaLib/Desktop/Debug/libsimbaLib.a(crc8message.o): in function `QByteArray::detach()':
/usr/include/x86_64-linux-gnu/qt5/QtCore/qbytearray.h:501: error: undefined reference to `QByteArray::reallocData(unsigned int, QFlags<QArrayData::AllocationOption>)'
:-1: error: /home/pathToProjects/ScarTest/../build/simbaLib/Desktop/Debug/libsimbaLib.a(crc8message.o): in function `QByteRef::operator=(char)':
/usr/include/x86_64-linux-gnu/qt5/QtCore/qbytearray.h:542: error: undefined reference to `QByteArray::expand(int)'
:-1: error: /home/pathToProjects/ScarTest/../build/simbaLib/Desktop/Debug/libsimbaLib.a(crc8message.o): in function `QTypedArrayData<char>::deallocate(QArrayData*)':
/usr/include/x86_64-linux-gnu/qt5/QtCore/qarraydata.h:228: error: undefined reference to `QArrayData::deallocate(QArrayData*, unsigned long, unsigned long)'
:-1: error: /home/pathToProjects/ScarTest/../build/simbaLib/Desktop/Debug/libsimbaLib.a(qftp.o): in function `QFtpDTP::read(char*, long long)':
/home/pathToProjects/simbaLib/qftp.cpp:376: error: undefined reference to `QByteArray::remove(int, int)'

解决方法 #

• 统一Qt版本环境：错误信息显示编译时调用了系统Qt5的头文件（/usr/include/x86_64-linux-gnu/qt5/），但链接的是Qt6库，版本不匹配导致报错。
  1. 打开Qt Creator的工具->选项->构建和运行->Qt版本，确认选中的是Qt6.6的qmake路径，排除系统自带的Qt5 qmake。
  2. 在项目构建配置中切换到Qt6.6对应的Kit，右键项目选择清理，删除旧构建目录后重新构建。
• 重新编译依赖静态库：报错中的libsimbaLib.a是Qt5环境下编译的静态库，Qt6无法直接兼容使用。需要将simbaLib子项目也切换到Qt6.6环境重新编译，生成适配Qt6的静态库后再链接。
• 修复子项目配置：如果子项目使用了Qt5特有的API（比如示例中的QFtp，Qt6已移除），需在子项目的.pro文件中同样添加QT += core5compat，确保所有依赖Qt5 API的模块都能链接到兼容库。
• 排除系统Qt5干扰：Debian 12预装的Qt5开发包可能干扰编译，可在主项目和子项目的.pro文件中添加以下配置，强制使用Qt6的头文件和库：

  INCLUDEPATH -= /usr/include/x86_64-linux-gnu/qt5
  LIBS -= -lQt5Core
  

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