在Debian上使用PySide2触发警告及启动失败问题求助

我之前在Debian 10上跑PySide2的GUI程序时，也碰到过几乎一模一样的报错，折腾了好一阵才找到靠谱的解决办法，给你分享几个亲测有效的方案：

1. 补全xcb插件的系统依赖 #

报错里提到“找到xcb插件但无法加载”，这大概率是系统缺少PySide2的xcb插件依赖的底层库。直接在终端执行以下命令安装所需依赖：

sudo apt-get update && sudo apt-get install libxcb-xinerama0 libxcb-xinput0 libxcb-cursor0 libxcb-randr0 libxcb-xtest0 libxcb-shape0 libxcb-xkb-dev

这些都是Qt的xcb平台插件必须的系统库，pip安装的PySide2不会自带这些系统级组件，所以必须手动补上。

2. 强制Qt使用XCB并修正显示变量 #

你的报错里提到了Wayland的警告，Gnome环境下Qt默认会忽略Wayland，但有时候会导致显示连接异常。可以通过设置环境变量解决：

• 先确认当前显示变量：执行 echo $DISPLAY，如果输出不是:0，手动设置：

  export DISPLAY=:0
  

• 强制Qt使用xcb平台插件，避免Wayland的干扰：

  export QT_QPA_PLATFORM=xcb
  

  你可以把这两行命令加到程序的启动脚本里，或者在运行Python程序前先执行它们，比如：

  export DISPLAY=:0
  export QT_QPA_PLATFORM=xcb
  python your_project.py
  

3. 改用系统自带的PySide2包（替代pip安装版） #

pip安装的PySide2可能和Debian 10的系统Qt库存在兼容性问题，试试换成系统包管理器安装的版本：

1. 先卸载pip版的PySide2：

   pip uninstall -y PySide2
   

2. 安装系统自带的PySide2组件：

   sudo apt-get install python3-pyside2.qtgui python3-pyside2.qtwidgets
   

   这种方式会自动处理所有依赖的兼容性，适合Debian这类稳定发行版。

4. 检查X11显示权限 #

如果以上方法都不行，可能是当前用户没有访问X11显示的权限，临时开放权限试试：

xhost +local:

如果生效了，可以把这行命令加到~/.bashrc里，让它每次登录自动执行。

如果还是不行，建议重启一下系统或者X11会话，确保新安装的依赖生效。

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