如何配置PyQt GUI以适配不同显示器尺寸与分辨率？

手动按屏幕比例计算相对坐标的方案缺陷 #

手动按屏幕宽高比例计算控件尺寸、坐标的方案不推荐作为通用适配方案，存在明显缺陷：

• 维护成本极高：每新增一个控件都要手动计算位置、尺寸比例，窗口大小调整时还要重写resizeEvent遍历所有控件重新赋值，漏改一个就会出现错位、遮挡
• 没有解决高DPI渲染的核心问题：这种方式只是硬改控件的像素尺寸，不会自动适配系统缩放比例，字体、图标、系统原生控件（比如下拉框、按钮边框）依然会出现过小、发虚的问题，不同DPI下的显示一致性很差

PyQt内置的官方高DPI适配方案（首选） #

Qt.AA_EnableHighDpiScaling是Qt官方提供的标准高DPI适配方案，正确使用方式如下：

注意：所有高DPI相关属性必须在QApplication实例创建之前设置，否则不会生效

import sys
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QApplication

# 开启高DPI全局缩放
QApplication.setAttribute(Qt.AA_EnableHighDpiScaling, True)
# 开启高DPI图标适配，避免图标发虚
QApplication.setAttribute(Qt.AA_UseHighDpiPixmaps, True)

app = QApplication(sys.argv)
# 后续按照全高清屏幕下的正常逻辑编写窗口、控件代码即可，不需要修改任何固定尺寸参数

这个方案的逻辑是Qt会自动读取当前系统的显示缩放比例（比如4K屏Windows默认200%缩放、2K屏默认125%缩放），全局自动缩放所有控件、字体、图标、边距，渲染效果和系统原生软件保持一致，全高清下调好的界面，在任何分辨率、任何缩放比例的屏幕上都不会出现过小的问题。
注：PyQt6/PySide6中这两个属性默认开启，不需要手动设置。

关于QT_FONT_DPI环境变量的说明 #

os.environ["QT_FONT_DPI"] = "96"的写法不推荐用于常规适配，这个参数是强制锁定Qt渲染的DPI基准值，设为96就是强制所有内容按100%缩放渲染，不仅无法适配高DPI屏幕，反而会让界面和系统缩放比例脱节，出现大小异常、发虚的问题，仅适合特定版本Qt出现缩放bug时临时排障使用，常规开发不要添加这个配置。

多分辨率适配的最佳实践 #

开启全局高DPI缩放后，只需要遵循一个原则就能适配所有分辨率：不要用固定坐标定位控件，使用Qt内置布局管理器

• 放弃手动写setGeometry固定控件坐标、尺寸的写法，用QVBoxLayout（垂直布局）、QHBoxLayout（水平布局）、QGridLayout（网格布局）嵌套排布所有控件
• 配合控件的sizePolicy、最小/最大尺寸属性做约束，布局管理器会自动根据窗口大小、系统缩放比例调整所有控件的位置和大小，完全不需要手动计算比例
• 如果是用Qt Designer拖放生成UI，只要给顶层窗口应用布局（比如选中顶层窗口后点击水平布局/垂直布局按钮），所有控件就会自动纳入布局管理，不需要手动改代码

按屏幕比例计算窗口尺寸的逻辑，可以保留用来做特殊场景的窗口初始化（比如希望主窗口首次打开时占屏幕宽度的70%），但控件排布完全不需要手动计算，交给布局管理器即可。

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