如何在同一QML文件中兼容Qt5的QtGraphicalEffects与Qt6的Qt5Compat.GraphicalEffects

方案1：直接使用QML条件导入（最简便，无需修改构建配置） #

QML原生支持基于Qt版本的条件导入语句，直接在QML文件头部按如下写法即可：

import QtQuick 2.15
import QtQuick.Controls 2.15

// 条件导入GraphicalEffects
#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
import Qt5Compat.GraphicalEffects
#else
import QtGraphicalEffects 1.15
#endif

• 导入的版本号可以根据你项目支持的最低Qt版本调整，Qt5下QtGraphicalEffects的版本号和你导入的QtQuick版本保持一致即可
• 该方案无需修改任何构建系统配置，写完直接在Qt5、Qt6环境下都能正常编译运行，原有效果类的调用代码（比如DropShadow、ColorOverlay等）不需要做任何改动

方案2：封装统一别名模块（适合多文件项目，减少重复代码） #

如果你的项目里有大量QML文件都用到了GraphicalEffects，可以自己封装一个轻量的别名模块，避免每个文件都写条件导入：

1. 新建一个文件夹比如qml/MyGraphicalEffects
2. 在该文件夹下新建qmldir文件，配合构建系统的条件配置：
   • Qt5环境下的qmldir内容：

     module MyGraphicalEffects
     ColorOverlay 1.0 QtGraphicalEffects/ColorOverlay
     DropShadow 1.0 QtGraphicalEffects/DropShadow
     // 把你用到的所有效果类都按上面的格式加别名
     

   • Qt6环境下的qmldir内容：

     module MyGraphicalEffects
     ColorOverlay 1.0 Qt5Compat.GraphicalEffects/ColorOverlay
     DropShadow 1.0 Qt5Compat.GraphicalEffects/DropShadow
     // 同上统一加别名
     

3. 在qmake/CMake中增加条件逻辑，根据当前编译用的Qt版本，把对应的qmldir文件复制到构建目录的qml/MyGraphicalEffects路径下
4. 业务QML中统一导入import MyGraphicalEffects 1.0即可，效果类调用完全不用修改

额外注意事项 #

Qt6环境下需要在构建配置中额外引入Qt5Compat模块：

• qmake项目：QT += qt5compat
• CMake项目：find_package(Qt6 COMPONENTS 5Compat REQUIRED)，然后在目标链接库中加入Qt::5Compat
• 如果你用到了Qt5中已经被废弃的效果类，建议提前替换为Qt5Compat.GraphicalEffects中仍保留的对应类，避免编译报错

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