PySide6加载Qt Design Studio导出UI报错：Type App不可用等问题求助

核心问题分析 #

报错的根本原因是QtQuick.Studio.Components模块未找到，后续的类型不可用错误都是由此引发的连锁反应——该模块是Qt Design Studio专属组件，PySide6及PySide6-Addons默认不包含。

解决步骤 #

1. 添加Qt Design Studio的QML模块路径 #

找到你的Qt Design Studio安装目录下的qml文件夹（例如Windows下C:\Qt\QtDesignStudio\2.1.0\qml，Mac下~/Qt/QtDesignStudio/2.1.0/qml），在main.py中添加该路径到QML引擎的导入路径：

import sys
import qml.uifiles

from PySide6.QtCore import QUrl, QDir
from PySide6.QtGui import QGuiApplication
from PySide6.QtQml import QQmlApplicationEngine

if __name__ == "__main__":
    app = QGuiApplication(sys.argv)
    engine = QQmlApplicationEngine()
    # 替换为你的Qt Design Studio实际qml路径
    qds_qml_dir = "C:/Qt/QtDesignStudio/2.1.0/qml"
    engine.addImportPath(QDir.toNativeSeparators(qds_qml_dir))
    engine.load(QUrl("qrc:/main.qml"))

    if not engine.rootObjects():
        sys.exit(-1)
    sys.exit(app.exec())

2. 修正QML导入路径 #

• main.qml中，import "qrc:/content"改为相对路径（因main.qml与content目录同级）：

  import QtQuick
  import "content"
  
  App {
  }
  

• App.qml中，import "qrc:/content"改为同目录导入：

  import QtQuick
  import QtQuick.Window
  import "."
  import QtQuick.VirtualKeyboard
  
  Window {
      // 原有代码保持不变
  }
  

3. 确认资源编译正确性 #

从项目根目录重新执行编译命令，确保资源路径匹配：

pyside6-rcc qml/uifiles.qrc -o qml/uifiles.py

4. 优化Qt Design Studio导出流程 #

直接使用Qt Design Studio的导出功能生成PySide6项目：菜单栏选择Project > Export > Export to PySide6 Project，该流程会自动处理模块依赖、资源配置及路径问题，避免手动导出的疏漏。

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