PyQt

很多PyQt程序把窗口点了关闭，界面消失了，但任务管理器里内存不降，甚至反复打开关闭后越涨越高。这类现象通常不是“Qt不回收”，而是对象仍被引用、线程或定时器仍在跑、信号连接形成了引用环，或某些缓存资源没有释放，从而导致Python的垃圾回收与Qt的QObject销毁条件始终不成立。排查的关键是把“窗口隐藏”与“对象销毁”区分开，再沿着引用链把最后一个持有者找出来。

PyQt应用打包后双击无反应或弹窗报错，定位思路通常不是从代码逻辑入手，而是先把运行时依赖与Qt插件加载链路跑通。尤其在Windows上，平台插件qwindows.dll的放置目录与插件搜索路径一旦不一致，程序就会在启动阶段直接退出。

在PyQt里做表格展示时，数据量一旦上到几万行甚至更多，常见现象是滚动卡顿、筛选排序迟缓、刷新时界面假死。要把性能拉回来，不能只靠硬件或零散的小优化，而是要先确认瓶颈出在控件选型、数据组织还是渲染更新，再用模型化与懒加载把一次性全量渲染改成分批可控的增量更新。

PyQt里一旦把耗时任务放进线程，很多人第一反应就是在线程里直接改Label文本、刷新进度条或弹出对话框，结果立刻报错或出现随机卡死。其根因是Qt的GUI对象有严格的线程归属，界面只能由主线程的事件循环来驱动更新；线程里做UI更新相当于绕开事件系统去“硬改”，轻则抛异常，重则内存状态被破坏。

PyQt做国际化时，最让人头疼的不是翻译内容，而是明明切了语言却看不出任何变化，或者只改了一部分，剩下的仍是原文。多数情况下问题集中在三处：翻译文件其实没有加载成功，翻译器安装顺序把优先级弄反了，界面没有在语言变化后重新取一遍可翻译字符串。把这三件事按顺序核对，定位会明显更快。

PyQt里样式表看起来“不生效”，经常不是QSS语法本身的问题，而是样式根本没有挂到正确对象上，或者挂上了但被后续样式覆盖，又或者选择器没有命中控件真实类型与层级。排查时要先把链路跑通，确认样式确实被应用，再去缩小到作用域与选择器细节，这样才能避免反复试错还找不到原因。

信号槽已经写了connect，界面也能正常显示，但点击按钮或状态变化时槽函数就是不进来，这类问题在PyQt里并不少见。多数情况下不是Qt失灵，而是信号根本没发出、连接连到了别的重载签名、对象提前被回收，或跨线程连接缺少事件循环导致消息到不了。排查时要按顺序把发射、连接、接收三段链路逐段证实，再去处理签名和生命周期，才能把现象从偶发变成可复现。

PyQt里资源文件加载失败，表面看是图标不显示或样式表找不到图片，实质通常是资源并未被编译进Qt资源系统，或运行时没有把资源模块加载进进程。只要把三件事核对清楚，问题一般能快速闭环：资源路径是否以:/开头、qrc是否正确编译为Python模块、启动时是否import了生成的资源模块。

PyQt在高分屏上发虚，通常不是字体本身不清晰，而是应用被系统按位图方式拉伸，或Qt在非整数缩放下对缩放因子做了舍入，导致界面尺寸与像素密度不匹配，最终出现模糊与比例异常并存的情况。处理这类问题要先明确你用的是Qt 5还是Qt 6，因为高DPI机制与开关在Qt 6里已默认开启且部分属性被弃用，然后再把缩放策略与素材分辨率补齐。

不少PyQt桌面工具在启动后会出现窗口已显示但点不动、列表迟迟不刷新的情况，用户感知往往是未响应或假死。问题通常不在控件本身，而在主线程事件循环被同步初始化与耗时逻辑占住，绘制与输入事件排队过久。把卡顿来源拆清楚，再把重任务从事件循环里分离出去，启动体验才能稳定且可复现地优化。