Ubuntu20.04启动git-cola失败 PyQt5.QtWidgets导入报undefined symbol错误

问题原因 #

该报错属于PyQt5绑定库与系统Qt5核心库版本不匹配，_ZTI13QOpenGLWidget是Qt5中QOpenGLWidget组件的符号，出现未定义错误说明当前加载的Qt5核心库版本低于PyQt5编译时依赖的版本，常见原因是手动安装过非系统源的Qt版本、环境变量配置了第三方Qt库路径、或pip安装的PyQt5与系统源PyQt5冲突。

解决方案 #

• 第一步：排查环境变量冲突
  执行命令查看动态库加载路径：

  echo $LD_LIBRARY_PATH
  

  如果输出中包含非系统默认的Qt路径（如/opt/Qt5.*、/usr/local/Qt），临时清空路径测试：

  unset LD_LIBRARY_PATH
  python3 -c "from PyQt5.QtWidgets import *"
  

  测试无报错的话，就删除~/.bashrc、~/.profile、/etc/profile.d/下配置的第三方Qt相关LD_LIBRARY_PATH条目，重启终端生效。
• 第二步：修复系统包版本冲突
  如果环境变量无问题，重装系统默认的Qt核心库和PyQt5相关包：

  sudo apt update
  sudo apt install --reinstall libqt5widgets5 libqt5opengl5 python3-pyqt5 python3-pyqt5.qtopengl git-cola
  

• 第三步：清理pip安装的冲突PyQt5版本
  若之前通过pip安装过PyQt5，卸载pip版本使用系统源版本即可：

  pip3 uninstall -y pyqt5 pyqt5-qt5
  

验证 #

操作完成后执行git-cola即可正常启动。

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