Linux下PyCharm用Pyplot绘图时Qt xcb插件加载失败求助

以下是几种可行的解决方案，按优先级尝试：

1. 切换Matplotlib后端 #

绕过Qt后端的问题，改用其他支持的后端：

• 在你的Python代码开头添加：

  import matplotlib
  # 尝试用TkAgg后端，适配大多数Linux桌面环境
  matplotlib.use('TkAgg')
  import matplotlib.pyplot as plt
  

• 如果仅需保存图片无需实时显示，可改用Agg后端：

  matplotlib.use('Agg')
  

• 也可修改Matplotlib配置文件永久生效：
  1. 运行python -c "import matplotlib; print(matplotlib.get_configdir())"找到配置目录
  2. 编辑目录下的matplotlibrc文件，将backend : Qt5Agg改为backend : TkAgg

2. 修复Qt平台插件路径冲突 #

PyCharm的虚拟环境可能与系统Qt插件路径冲突，手动指定系统插件路径：

• 在PyCharm中打开Run > Edit Configurations
• 在目标运行配置中添加环境变量：

  QT_QPA_PLATFORM_PLUGIN_PATH=/usr/lib/x86_64-linux-gnu/qt5/plugins/platforms/
  

• 或在终端启动PyCharm前先导出环境变量：

  export QT_QPA_PLATFORM_PLUGIN_PATH=/usr/lib/x86_64-linux-gnu/qt5/plugins/platforms/
  # 替换为你的PyCharm启动脚本路径
  ~/pycharm/bin/pycharm.sh
  

3. 安装完整的Qt运行时依赖 #

补充安装运行时库（之前安装的是开发包）：

sudo apt-get install libxcb-xinerama0 libxcb-randr0 libxcb-xtest0 libxcb-shape0 libxcb-xkb1 libxcb-cursor0

4. 重装Matplotlib和PyQt5 #

虚拟环境中的库可能损坏，卸载后重新安装：

# 激活虚拟环境后执行
pip uninstall -y matplotlib pyqt5
pip install matplotlib pyqt5

5. 避免用sudo启动PyCharm #

root权限会导致环境变量异常，始终以普通用户身份运行PyCharm。

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