VSCode集成终端运行matplotlib脚本提示Qt版本不兼容该如何修复

问题原因 #

该问题是VSCode集成终端的环境变量与外部系统终端不一致导致的：VSCode自带了旧版本Qt5.14.1的运行库，集成终端会优先加载该版本库，和你Python环境中安装的Qt5.15.2版本冲突，外部终端不会加载VSCode的自带运行库所以可以正常运行。

修复方案 #

• 方案1：修改matplotlib后端（最快生效）
  在你的Python脚本开头导入matplotlib的第一时间指定非Qt后端，避开版本冲突：

  import matplotlib
  # 不需要弹出绘图窗口仅需保存图片可替换为'Agg'
  matplotlib.use('TkAgg')
  import matplotlib.pyplot as plt
  

  如果需要全局生效，可执行以下代码找到matplotlib配置文件路径：

  import matplotlib
  print(matplotlib.matplotlib_fname())
  

  打开输出的matplotlibrc文件，修改backend字段为backend: TkAgg保存即可。

• 方案2：修改VSCode启动参数
  找到VSCode的桌面快捷方式，右键点击「属性」，在「目标」输入框的末尾追加参数--disable-gpu-sandbox，修改后路径示例：

  "C:\Program Files\Microsoft VS Code\Code.exe" --disable-gpu-sandbox
  

  保存后重启VSCode再运行脚本测试即可。

• 方案3：指定Qt插件路径
  在系统环境变量中新增QT_QPA_PLATFORM_PLUGIN_PATH变量，值设置为你当前使用的Python环境下的Qt插件路径，示例路径（根据你自己的Python环境调整）：

  C:\Users\你的用户名\anaconda3\envs\你的环境名\Library\plugins\platforms
  

  保存环境变量后重启VSCode生效。

• 方案4：统一Qt版本
  激活你使用的Python环境后，执行以下命令重装对应版本的Qt库：

  # pip安装的用户执行
  pip uninstall pyqt5 pyqt5-qt5 pyqt5-sip -y
  pip install pyqt5==5.15.2
  # conda安装的用户执行
  conda install pyqt=5.15.2 -y
  

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