Ubuntu 20.04中git-cola启动失败：PyQt5 .so文件未定义符号_ZTI13QOpenGLWidget问题求助

针对你遇到的ImportError: undefined symbol: _ZTI13QOpenGLWidget错误，这个问题本质是动态链接库依赖缺失或版本不匹配导致的，下面是几个可行的排查和解决步骤：

• 检查并安装Qt5 OpenGL依赖库
  QOpenGLWidget属于Qt5的OpenGL模块，你的系统可能缺少对应的底层库。先检查是否已安装：

  dpkg -l | grep libqt5opengl5
  

  如果没有任何输出，执行以下命令安装：

  sudo apt install libqt5opengl5 libqt5opengl5-dev
  

  安装完成后再尝试启动git-cola。

• 重新安装适配系统版本的PyQt5及相关组件
  有时候PyQt5的版本和系统预装的Qt库版本不兼容，导致符号无法解析。先确认系统Qt版本：

  qmake-qt5 --version
  

  然后检查当前PyQt5的安装来源（apt或pip）：

  # 检查apt安装的PyQt5
  dpkg -l | grep python3-pyqt5
  # 检查pip安装的PyQt5
  pip3 show PyQt5
  

  如果是pip安装的PyQt5，建议卸载后改用apt安装适配系统版本的包：

  pip3 uninstall -y PyQt5
  sudo apt install --reinstall python3-pyqt5 python3-pyqt5.qtopengl python3-qtpy
  

• 彻底重装git-cola及其依赖
  可能git-cola的依赖文件出现损坏或缺失，尝试彻底清除后重新安装：

  sudo apt remove --purge git-cola python3-pyqt5 python3-qtpy
  sudo apt autoremove --purge
  sudo apt install git-cola
  

  这会自动拉取并安装所有git-cola需要的兼容依赖。

• 检查动态链接库加载路径
  系统可能无法找到正确的Qt OpenGL库，用ldd检查QtWidgets.so的依赖情况：

  ldd /usr/lib/python3/dist-packages/PyQt5/QtWidgets.cpython-38-x86_64-linux-gnu.so | grep opengl
  

  如果输出中没有找到libQt5OpenGL.so.5，可以临时将Qt库路径加入环境变量后重试：

  export LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH
  git-cola
  

  如果有效，可以将这个环境变量添加到~/.bashrc或~/.profile中永久生效。

• 使用虚拟环境隔离安装
  如果系统全局包存在冲突，试试在虚拟环境中安装git-cola：

  # 创建并激活虚拟环境
  python3 -m venv git-cola-env
  source git-cola-env/bin/activate
  # 在虚拟环境中安装git-cola
  pip install git-cola
  # 启动git-cola
  git-cola
  

  虚拟环境会使用独立的依赖包，避免和系统全局包冲突。

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