PyQt QMainWindow调用居中方法后显示偏移如何解决

问题根源 #

窗口居中偏移和你使用的2560×1080显示器参数无关，核心问题有两个：

• 居中方法调用时机错误：你在窗口首次显示前的initUI()阶段就执行居中逻辑，此时Qt尚未完成窗口最终渲染，系统标题栏、窗口边框、菜单栏的实际尺寸没有被正确计入frameGeometry()的返回值，坐标计算天然存在偏差。
• 旧API兼容性问题：你使用的QDesktopWidget在Qt5后期已经被官方废弃，在高DPI缩放、多屏场景下本身存在坐标计算bug。

修复步骤 #

1. 替换废弃API，改写居中方法，适配高DPI场景：

   def center(self):
       # 自动获取窗口当前所在屏幕，兼容多屏场景
       screen = self.windowHandle().screen() if self.windowHandle() else QApplication.primaryScreen()
       # 获取屏幕可用工作区（自动扣除任务栏、系统Dock占用区域）
       screen_available_rect = screen.availableGeometry()
       # 获取窗口带边框的完整几何尺寸
       window_rect = self.frameGeometry()
       # 计算居中坐标并移动窗口
       window_rect.moveCenter(screen_available_rect.center())
       self.move(window_rect.topLeft())
   

2. 调整居中方法的调用时机，不要在initUI()或者__init__方法里调用self.center()，二选一即可：
   • 方式一：在窗口显示完成后再调用居中

     if __name__ == "__main__":
         import sys
         from PyQt5.QtWidgets import QApplication
         # 高DPI适配，避免缩放导致的坐标偏移，放在创建app前执行
         QApplication.setHighDpiScaleFactorRoundingPolicy(Qt.HighDpiScaleFactorRoundingPolicy.PassThrough)
         QApplication.setAttribute(Qt.AA_EnableHighDpiScaling)
         QApplication.setAttribute(Qt.AA_UseHighDpiPixmaps)
     
         app = QApplication(sys.argv)
         main_win = WindowMain()
         main_win.show() # 先完成窗口渲染、尺寸计算
         main_win.center() # 渲染完成后再执行居中
         sys.exit(app.exec_())
     

   • 方式二：重写窗口显示事件，自动在首次显示时居中，不需要外部调用
     在WindowMain类中添加如下方法：

     def showEvent(self, event):
         # 标记位保证居中逻辑仅在首次显示时执行一次
         if not hasattr(self, '_first_shown'):
             self.center()
             self._first_shown = True
         super().showEvent(event)
     

额外说明 #

所有依赖窗口实际渲染尺寸的操作（比如居中、取窗口坐标、按窗口尺寸定位弹框）都要等窗口完成首次show()之后再执行，初始化阶段Qt拿到的是窗口尺寸的预估值，和实际渲染后的尺寸存在差值，必然导致定位偏移。

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