Qt4迁移至Qt5时QX11Info头文件找不到问题求助

• 确认QtX11Extras组件的安装与项目配置
  • 系统层面安装对应开发包：Debian/Ubuntu系执行sudo apt install libqt5x11extras5-dev，RHEL/CentOS系执行sudo dnf install qt5-qtX11extras-devel
  • qmake项目：在.pro文件中添加QT += x11extras
  • CMake项目：在CMakeLists.txt中添加

    find_package(Qt5 REQUIRED COMPONENTS X11Extras)
    target_link_libraries(你的库名 Qt5::X11Extras)
    

• 调整头文件引用逻辑
  Qt5中QX11Info的头文件路径虽仍为<QX11Info>，但必须确保项目已正确引入X11Extras模块，否则编译器无法定位该头文件。若仍有问题，可尝试手动指定QtX11Extras的包含路径（正常配置模块后无需此操作）。
• 编译库的关键注意事项
  • 编译迁移后的代码时，必须全程使用Qt5工具链（切换到Qt5的qmake，或在CMake中指定Qt5路径），禁止混用Qt4编译环境。
  • 适配QX11Info的API变更：Qt5部分API有调整，比如原Qt4的QX11Info::display()在Qt5中仍可用，但部分场景需结合QWidget的x11Info()方法调用，需根据实际代码修改。
  • 若编译动态库，需确保Qt5的X11Extras库在运行时可被加载，可通过设置LD_LIBRARY_PATH指定Qt5库路径。

内容的提问来源于stack exchange，提问作者杨建国