如何避免跨显示器DPI/分辨率差异导致PyQtGraph坐标轴缩放异常

问题现象 #

在笔记本内置屏幕上运行PyQtGraph绘图程序时，坐标轴刻度、数据比例显示完全正常。当把绘图窗口从笔记本屏幕拖拽到外接第二台显示器时，会出现明显的显示异常：

• 坐标轴被异常压缩，数据点和刻度值的对应关系错位，绘图缩放比例完全失效

网传存在缺陷的现有方案 #

目前社区里能搜到的两类解决方案，都存在明显硬伤，无法直接使用：

• 统一两台显示器系统分辨率：强制把笔记本高分辨率屏幕的显示参数降到外接低分辨率显示器的水平，以牺牲笔记本屏幕的显示清晰度为代价换取兼容，实用性极低。
• 强制锁定系统DPI为96：在代码中添加app.setAttribute(QtCore.Qt.AA_Use96Dpi)，要求Qt完全忽略操作系统的DPI缩放设置。这个方案表面上能让外接显示器的显示恢复正常，实则存在严重的隐性问题：强制锁DPI后，笔记本内置屏上的坐标轴刻度会出现数值偏移，同一份测试数据会出现x轴量程错误显示为0-7000、y轴量程错误显示为-2到-26dB的问题，视觉上看起来绘图比例正常，但实际数据和刻度已经完全脱节，这种隐性错误比肉眼可见的变形风险更高，很容易被忽略导致数据分析偏差。

网传方案附带的示例代码还存在属性设置时机错误的问题：

def main():
 import sys
 app = QtWidgets.QApplication(sys.argv)
 # 此时QApplication已经实例化，后续设置属性完全不生效
 app.setAttribute(QtCore.Qt.AA_Use96Dpi)
 MainWindow = GraphWindow()
 MainWindow.show()
 sys.exit(app.exec_())

问题根因 #

出现这类异常的核心原因是Qt框架早期的多屏DPI适配逻辑不完善，和PyQtGraph本身的绘图计算逻辑无关：

• Qt默认不会在窗口跨屏移动时动态读取当前屏幕的DPI值，会沿用窗口首次创建时所在屏幕的DPI参数计算绘图区域的物理尺寸。当窗口移动到DPI参数不同的第二块屏幕时，坐标轴的刻度映射逻辑仍沿用旧的DPI值，就会出现刻度和实际像素长度不匹配、数据被压缩的问题。
• PyQtGraph的坐标轴自动范围计算是绑定绘图控件实际像素尺寸的，当Qt的DPI计算参数和屏幕实际参数不匹配时，自动计算出来的刻度范围就会出现数值错位。
• AA_Use96Dpi方案相当于把整个应用的DPI计算值强制锁死为固定的96，不管在哪个屏幕上都用同一套固定参数计算，虽然能解决跨屏时的逻辑不一致问题，但完全牺牲了高DPI屏幕的原生缩放适配，导致正常屏幕上的刻度、绘图比例被强行拉伸，出现数据和物理长度不匹配的问题。

无副作用的正确实现方法 #

要实现“窗口跨屏移动时自动适配当前显示器DPI、刻度始终和真实数据一一对应、不牺牲单屏原生显示清晰度”的目标，需要正确配置Qt的高DPI适配属性，所有适配属性必须在QApplication实例创建之前完成设置，否则配置完全不生效：
可直接运行的最小复现+修复代码如下：

from PyQt5 import QtWidgets, QtCore
from pyqtgraph import PlotWidget
import sys
from numpy.random import seed, randint

# 必须在QApplication实例化前开启高DPI动态适配
QtCore.QCoreApplication.setAttribute(QtCore.Qt.AA_EnableHighDpiScaling)
QtCore.QCoreApplication.setAttribute(QtCore.Qt.AA_UseHighDpiPixmaps)
# 注意：不要添加AA_Use96Dpi属性，该属性会强制锁死DPI值引入隐性显示错误

class MainWindow(QtWidgets.QMainWindow):
    def __init__(self, *args, **kwargs):
        super(MainWindow, self).__init__(*args, **kwargs)
        self.graphWidget = PlotWidget()
        self.setCentralWidget(self.graphWidget)

        # 测试用固定随机数生成的数据集
        x = list(range(1, 11))
        seed(1)
        y = randint(5, 35, 10)
        self.graphWidget.plot(x, y)

def main():
    # 所有DPI适配配置已在QApplication创建前完成
    app = QtWidgets.QApplication(sys.argv)
    main_window = MainWindow()
    main_window.show()
    sys.exit(app.exec_())

if __name__ == '__main__':
    main()

配置注意事项 #

• 不要把高DPI相关的属性设置写在QApplication实例化语句之后，此时应用初始化流程已经走完，所有属性设置都不会生效。
• 上述配置开启后，Qt会在窗口跨屏移动时动态读取当前屏幕的真实DPI值，自动调整绘图区域的坐标映射比例，不管窗口在哪个屏幕上，坐标轴的刻度长度、数值和数据的对应关系都不会出现变形或错位。
• 如果使用的是PyQt6版本，上述高DPI适配属性默认处于开启状态，不需要手动添加配置，本身就支持多屏动态DPI切换。

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