Qt Designer预览与pyuic5生成UI尺寸差异及DPI配置问题

• DPI缩放策略不匹配：Qt Designer预览时的DPI缩放规则和运行Python程序（或打包后）的不一致。Qt 5.6+默认启用高DPI缩放，但Designer可能直接沿用系统缩放，而Python环境里的Qt缩放策略没配置到位，导致控件尺寸、布局比例出现偏差。
• 版本不一致：你的PyQt5Designer是5.14.1，而PyQt5核心库和Qt5基础库都是5.15.x，版本差会导致Designer的预览渲染逻辑和运行时存在细微差异。
• PyInstaller打包配置缺失：打包时没正确处理Qt的DPI相关配置，导致打包后的程序无法正确读取系统DPI设置，进而出现尺寸异常。

一、Qt Designer中的DPI设置 #

• 打开Qt Designer，点击菜单栏编辑→偏好设置，切换到界面选项卡：
  • 勾选使用系统DPI，让Designer预览和系统缩放保持一致；
  • 如果需要固定缩放比例，可手动设置缩放因子（比如1.0、1.25），让预览效果和目标运行环境匹配。
• 设计UI时优先用布局管理器（QVBoxLayout、QHBoxLayout、QGridLayout等），别用固定控件坐标和尺寸。布局会自动适配不同DPI和窗口大小，大幅减少缩放偏差。
• 避免用绝对像素值设置控件大小、间距，改用相对尺寸或布局的拉伸因子。

二、Python运行时的DPI配置 #

在生成的Python文件入口（或主程序启动代码）里添加以下内容，强制Qt使用统一的DPI缩放策略：

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

if __name__ == "__main__":
    # 启用高DPI缩放支持
    QApplication.setAttribute(Qt.AA_EnableHighDpiScaling)
    # 使用系统原生高DPI像素图，避免字体/控件模糊
    QApplication.setAttribute(Qt.AA_UseHighDpiPixmaps)
    app = QApplication(sys.argv)
    # 这里放你的窗口初始化代码
    # ...
    sys.exit(app.exec_())

三、PyInstaller打包的配置调整 #

• 打包时用以下命令，确保DPI相关配置被正确打包：

  pyinstaller --onefile --windowed --name your_app_name --add-data "qt.conf;." your_main_script.py
  

• 在主脚本同目录下创建qt.conf文件，内容如下：

  [Platforms]
  WindowsArguments = dpiawareness=2
  

  这个配置会强制Windows平台下的程序使用系统级DPI感知，避免缩放异常。

额外注意事项 #

• 尽量统一PyQt5组件版本，比如把PyQt5Designer升级到5.15.x，减少版本差异带来的渲染问题。
• 测试时在目标系统上运行，Windows、Mac、Linux的DPI处理逻辑略有不同，需要针对性验证。

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