PyQt5中QT_DEVICE_PIXEL_RATIO弃用警告及GUI卡顿问题求助

最近把旧电脑上开发的Qt应用克隆到新笔记本后，踩了几个坑，这里分享下问题现象和解决过程：

问题表现 #

刚启动应用就遇到一堆问题：

• 控制台弹了个弃用警告：

  警告：QT_DEVICE_PIXEL_RATIO已被弃用，请改用：QT_AUTO_SCREEN_SCALE_FACTOR以启用平台插件控制的单屏缩放系数；QT_SCREEN_SCALE_FACTORS用于设置单屏缩放系数；QT_SCALE_FACTOR用于设置应用全局缩放系数。

• GUI界面直接超出屏幕范围，看不到完整窗口
• 点击按钮、hover控件这些操作完全没响应，程序还频繁卡顿，根本没法用

卡顿问题的排查与修复 #

一开始我以为是Qt的屏幕缩放适配问题，折腾了半天缩放参数，结果卡顿还是没解决。后来仔细排查应用的日志和模块，才发现问题出在网页爬虫部分：我的爬虫会导出lxml类型的数据，但自定义的错误处理器压根没考虑这种类型的错误，导致错误被默默吞掉了，没抛出任何提示，结果程序内部因为未处理的错误一直卡在异常状态，直接把GUI线程给堵死了。

修复起来也简单：给自定义错误处理器加了对lxml类型错误的处理逻辑，确保这类错误能被正常捕获、记录和处理，之后程序就不再卡顿了，交互也恢复正常。

解决Qt缩放警告与GUI超屏问题 #

那个弃用警告虽然不是卡顿的直接原因，但也是个需要处理的点，而且它还导致了GUI超屏的问题。根据警告提示，我们可以用推荐的环境变量来替换过时的QT_DEVICE_PIXEL_RATIO：

• 让系统自动适配屏幕缩放：设置QT_AUTO_SCREEN_SCALE_FACTOR=1
• 给不同屏幕单独设置缩放：比如QT_SCREEN_SCALE_FACTORS="HDMI-1=1.5;DP-1=2.0"（根据你的屏幕名称调整）
• 全局统一缩放整个应用：设置QT_SCALE_FACTOR=1.25

可以在代码里设置，比如在main函数开头添加：

#include <QCoreApplication>

int main(int argc, char *argv[]) {
    // 启用系统自动缩放
    qputenv("QT_AUTO_SCREEN_SCALE_FACTOR", "1");
    QApplication a(argc, argv);
    // 后续窗口初始化代码...
    return a.exec();
}

也可以在启动应用前通过终端设置（以Windows为例，用PowerShell）：

$env:QT_AUTO_SCREEN_SCALE_FACTOR=1; .\your_app.exe

设置后，警告消失，GUI界面也能正常适配新笔记本的屏幕了。

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