PySide6/Qt C++运行时设置自定义QML样式的问题求助

核心问题修正步骤 #

1. 调整样式设置的调用顺序 #

QQuickStyle.setStyle必须在创建QQmlApplicationEngine实例之前执行——引擎初始化时会读取样式配置，顺序颠倒会导致设置完全无效。

修正后的main.py代码：

import sys
import os
from PyQt6.QtWidgets import QApplication
from PyQt6.QtQml import QQmlApplicationEngine
from PyQt6.QtQuickControls2 import QQuickStyle

app = QApplication(sys.argv)
# 先设置样式，再初始化引擎
QQuickStyle.setStyle("MyStyle")
engine = QQmlApplicationEngine()
# 添加自定义模块所在的父目录到QML导入路径
engine.addImportPath(os.path.dirname(__file__))
engine.load(QUrl.fromLocalFile(f"{os.path.dirname(__file__)}/QML/Main.qml"))
app.exec()

2. 正确配置QML导入路径 #

你需要将自定义样式模块的父目录（也就是MyApp根目录）添加到导入路径，而非MyStyle目录本身。引擎会自动在导入路径下查找名为MyStyle的文件夹，并读取其中的qmldir文件。

注意用addImportPath追加路径，不要用setImportPathList——后者会覆盖系统默认的QML模块路径，导致原生控件模块也无法加载。

3. 对齐模块版本号 #

qmldir中的控件版本号要和QML文件里导入的模板版本匹配：
你的qmldir写的是ToolTip 3.0，但QML文件导入的是QtQuick.Templates 2.0，版本不匹配会导致引擎无法正确识别模块。修正后的qmldir：

module MyStyle
ToolTip 2.0 ToolTip.qml

4. 验证业务QML的控件使用方式 #

确保Main.qml中使用的是QtQuick.Controls提供的ToolTip（而非直接用模板控件），且没有局部覆盖样式：

import QtQuick.Controls 2.15

Button {
    text: "Hover to see tooltip"
    ToolTip.visible: hovered
    ToolTip.text: "This uses custom style"
}

额外检查项 #

• 确认MyStyle目录下的qmldir、ToolTip.qml文件名拼写正确（区分大小写）；
• 如果用Qt5，API逻辑一致，但需注意QtQuick.Controls的版本对应关系。

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