PyQt6无边框窗口经PyInstaller编译后在Fedora上move()失效问题

核心原因 #

1. Wayland与X11后端差异：Fedora 40默认使用Wayland作为显示服务器，PyQt6的move()函数在Wayland环境下会受窗口管理器（compositor）限制——Wayland设计上不允许应用直接强制设置窗口位置，compositor有权忽略这类请求。而VS Code运行时会自动启用XWayland兼容模式（即使用X11后端），因此move()能正常生效；macOS的显示系统逻辑无此限制，所以编译后也能正常运行。

2. 环境变量不一致：VS Code会为运行的Python进程注入QT_QPA_PLATFORM=xcb这类环境变量，强制PyQt使用X11后端；但终端直接运行或PyInstaller编译后的程序，默认会调用Wayland后端，导致move()功能失效。

解决方法 #

1. 强制使用X11后端 #

• 终端运行源码：启动时指定环境变量

  QT_QPA_PLATFORM=xcb python test.py
  

• PyInstaller编译后运行：启动程序前设置环境变量

  QT_QPA_PLATFORM=xcb ./test
  

• 永久生效（当前用户）：在~/.bashrc或~/.zshrc中添加

  export QT_QPA_PLATFORM=xcb
  

• 嵌入到程序代码：在导入PyQt模块前设置环境变量

  import os
  os.environ['QT_QPA_PLATFORM'] = 'xcb'
  from PyQt6.QtWidgets import QWidget, QApplication
  # 后续业务代码...
  

2. 适配Wayland环境的窗口定位 #

若不想依赖X11，可尝试Wayland兼容的写法：

• 通过QScreen获取屏幕尺寸，计算目标位置后用setGeometry()替代move()

  screen = QApplication.primaryScreen()
  screen_geo = screen.geometry()
  window_width = 400  # 替换为你的窗口实际宽度
  target_x = screen_geo.width() - window_width
  target_y = 0
  self.setGeometry(target_x, target_y, window_width, screen_geo.height())
  

  注：Wayland下部分窗口管理器仍可能调整窗口位置，最终效果取决于系统的窗口管理策略。

3. 调试排查手段 #

• 打印当前Qt平台后端，确认环境差异：

  import os
  print("QT_QPA_PLATFORM:", os.environ.get('QT_QPA_PLATFORM', 'default'))
  

• 打印屏幕和窗口几何信息，验证位置计算是否正确：

  screen = QApplication.primaryScreen()
  print("Screen geometry:", screen.geometry())
  self.move(target_x, target_y)
  print("Window position after move:", self.pos())
  

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