SuperAPI AI 工具集

qt-debugging

测试与质量

查看项目

更新于 10-16 06:22

技能介绍

用途:诊断并修复 Qt 应用运行期问题,包括崩溃、事件循环异常、控件渲染失败、段错误和常见运行时错误。

主要能力:给出系统化排查流程——先完整阅读 Qt 警告输出,再按失败类型分类,用最小用例复现,最后用 QT_QPA_PLATFORM=offscreen pytest 验证修复。覆盖的典型类别有:控件不显示(未调用 show()、父控件未显示、尺寸或边距为零、在事件循环退出后创建等);访问控件时段错误(Python 中控件被垃圾回收,应保存为 self 属性);跨线程创建带父对象 QObject 的报错;在 QApplication 之前创建 QPixmap/QImage/QIcon;访问已被 Qt 删除的 C++ 对象(deleteLater 异步删除);主线程阻塞导致界面无响应;信号已连接但不触发;内存与资源泄漏检测。

使用方式:通过环境变量开启详细日志,如 QT_LOGGING_RULES=".debug=true" python -m myapp,或按类别过滤 qt.qpa.、qt.widgets.;C++ 用 qputenv("QT_LOGGING_RULES", ".debug=true");Python 可用 qInstallMessageHandler 捕获 Qt 输出。文中还提供控件树转储、事件循环层级检查、QSS 样式调试(unpolish/polish/update)、objgraph 统计对象增长等诊断片段,以及 C++ 侧 ASAN 与 qDebug 用法。

适用场景:Qt/PySide/PyQt 桌面应用开发调试。

限制:资料未提供安装命令、版本要求、收费信息及具体平台支持范围,暂未提供。