PyQt5登录表单在Windows与Linux系统间的显示差异排查求助

我之前也碰到过类似的跨平台布局适配问题，尤其是老版本Linux发行版（比如你提到的Ubuntu14.04、Mint17.03）和Windows之间的Qt样式/布局差异，给你整理几个实用的排查方向：

1. 检查Qt版本差异 #

Ubuntu14.04默认的Qt版本是Qt5.2左右，而Windows上你用的可能是更新的PyQt5版本（比如5.9+），不同版本的布局引擎对控件尺寸的计算逻辑有差异：

• 先在Linux环境下运行python -c "from PyQt5.QtCore import QT_VERSION_STR; print(QT_VERSION_STR)"查看Qt版本
• 如果版本过低，尝试升级PyQt5到兼容该系统的最高版本（比如Ubuntu14.04最多支持到PyQt5.11左右），看是否能解决

2. 验证布局的尺寸约束设置 #

Designer里的布局和控件属性很容易被忽略，尤其是和尺寸相关的：

• 打开Designer，选中输入字段（QLineEdit），检查右侧属性面板：
  • minimumHeight：是否设置了合理的最小值？如果没设，老版本Qt可能会把控件压缩到最小
  • sizePolicy：垂直方向的策略是不是Preferred或者Expanding？如果是Fixed或者Minimum可能导致挤压
• 检查网格布局的属性：
  • verticalSpacing和horizontalSpacing是否设置了合适的值？老版本布局可能默认间距为0导致控件拥挤
  • 布局的contentsMargins是不是被意外设成了很小的值？

3. 系统样式（Style）的影响 #

Linux下的Qt默认样式（比如GTK+样式）和Windows的WindowsVista样式对控件的默认尺寸处理不同：

• 可以在代码里强制设置统一的样式，测试是否是样式导致的问题：

  from PyQt5.QtWidgets import QApplication, QStyleFactory
  app = QApplication([])
  # 强制使用Fusion样式（跨平台统一）
  app.setStyle(QStyleFactory.create("Fusion"))
  

• 如果切换到Fusion样式后显示正常，说明是系统原生样式的适配问题，你可以要么强制用Fusion，要么针对Linux系统调整控件的最小高度

4. 字体大小的影响 #

Linux系统的默认字体大小或DPI设置和Windows不同，可能导致布局计算出错：

• 在Designer里，检查表单的默认字体是否设置为跨平台一致的字体（比如Arial、Segoe UI），避免使用系统专属字体
• 尝试在代码里显式设置控件的字体大小：

  from PyQt5.QtGui import QFont
  line_edit.setFont(QFont("Arial", 10))
  

5. 布局嵌套的问题 #

你用了垂直布局+网格布局的嵌套，可能在嵌套层级里有冲突的约束：

• 打开Designer的Form菜单，选择Preview in，分别选择不同的样式（比如Fusion、GTK+）预览，看是不是在预览阶段就出现挤压
• 尝试简化布局，比如先单独测试网格布局里的输入框，再嵌套到垂直布局，逐步排查是哪一层布局导致的问题

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