从Qt5.15.2迁移至Qt6.5后Win64端Material样式失效求助

问题现象 #

应用从Qt5.15.2迁移至Qt6.5后，本地运行正常，客户机部署后显示空白屏幕，日志出现乱码错误：

qrc:/CustomTextField.qml:4 ??? �TextField� ??????????
qrc:/qt-project.org/imports/QtQuick/Controls/Material/TextField.qml:36 ??? �CursorDelegate� ??????????
qrc:/qt-project.org/imports/QtQuick/Controls/Material/impl/CursorDelegate.qml:14 Connections ?? ???????? ?????

已确认Material插件已部署，Qt5.15.2版本无此问题。

排查与解决步骤 #

• 修正Qt6控件导入与样式配置
  Qt6中Qt Quick Controls 2的导入路径和样式逻辑有变更：

  1. 确保qtquickcontrols2.conf配置格式正确：

     [Controls]
     Style=Material
     
     [Material]
     Theme=Light # 按需设置Dark
     

  2. QML文件中使用Qt6版本的控件导入，替换原Qt5的导入语句：

     import QtQuick.Controls 6.2
     

     避免混用QtQuick.Controls 2.x的导入路径。

• 修复资源文件编码问题
  日志乱码多因QML文件编码不兼容Qt6的UTF-8要求：

  1. 将所有自定义QML文件（如CustomTextField.qml）转换为UTF-8无BOM编码；
  2. 重新编译QRC资源文件，确保编译过程使用UTF-8编码。

• 完善windeployqt部署参数
  即使确认Material插件存在，仍需确保部署完整：
  运行windeployqt时添加明确参数，强制包含Qt Quick Controls 2和Material样式：

  windeployqt --qmldir . --style material your_app.exe
  

  检查客户机应用目录下的qml/QtQuick/Controls/Material路径，确认所有qml文件及qtquickcontrols2materialplugin.dll等插件存在，且版本与Qt6.5完全一致。

• 修复Connections组件的Qt6兼容性
  Qt6对Connections组件的信号连接要求更严格：
  检查CursorDelegate.qml中的Connections代码，确保信号名称完全匹配，避免隐式连接。例如，Qt5中省略参数的信号写法可能在Qt6中失效，需显式匹配信号签名，或使用function语法处理：

  Connections {
      target: textInput
      function onTextChanged(newText) {
          // 处理逻辑
      }
  }
  

• 清除客户机环境干扰
  客户机可能存在旧版Qt环境变量干扰：

  1. 部署时添加--no-translations --no-system-d3d-compiler参数，避免依赖系统中的Qt文件；
  2. 确保应用目录下的Qt6Core.dll、Qt6Qml.dll等核心库为Qt6.5版本，且未被系统环境变量中的旧版Qt覆盖。

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