PyQt5 GUI通过SSH在服务器运行时xcb插件加载失败求助

1. 修正包安装命令（针对找不到libxcb-xinerama0的问题） #

出现E: Unable to locate package libxcb-xinerama0是因为不同Linux发行版的包名或源配置问题：

• 先确认系统发行版：

  cat /etc/os-release
  

• Debian/Ubuntu系：先更新软件源再安装开发版包（部分系统里普通版包名可能被合并）

  sudo apt update
  sudo apt install libxcb-xinerama0-dev
  

• CentOS/RHEL系：用yum/dnf安装对应包

  sudo yum install libxcb-xinerama
  # 或用dnf（CentOS 8+）
  sudo dnf install libxcb-xinerama
  

2. 直接指定Qt使用无界面平台插件 #

SSH连接下没有图形显示环境，强制让PyQt5使用offscreen插件绕过xcb依赖：

• 运行前设置环境变量：

  export QT_QPA_PLATFORM=offscreen
  python3 你的PyQt程序文件名.py
  

• 在代码内设置（永久生效）：在Python代码最开头添加

  import os
  os.environ['QT_QPA_PLATFORM'] = 'offscreen'
  

3. 手动指定Qt插件路径 #

如果Qt无法自动找到插件目录，手动设置路径：

• 先找到PyQt5的插件目录：

  python3 -c "import PyQt5; print(PyQt5.__path__[0] + '/plugins')"
  

• 设置环境变量后运行程序（替换成上面输出的路径）：

  export QT_PLUGIN_PATH=/path/to/PyQt5/plugins
  export QT_QPA_PLATFORM=offscreen
  python3 你的PyQt程序文件名.py
  

4. 重装PyQt5修复损坏的包 #

如果以上步骤无效，可能是PyQt5包损坏或版本不兼容，卸载重装：

pip uninstall -y PyQt5 PyQt5-sip
pip install PyQt5

如果是系统级安装，用系统包管理器：

# Debian/Ubuntu
sudo apt install --reinstall python3-pyqt5
# CentOS/RHEL
sudo yum reinstall python3-qt5

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