Ubuntu 22.04+Python3.10下PyQt6的libQt6Core.so.6导入错误求助

AI 小北

2026-8-22

Ubuntu 22.04下PyQt6导入libQt6Core.so.6失败的解决方法

问题重现

将系统升级至Ubuntu 22.04后，使用Python3.10运行依赖PyQt6的代码时，出现如下导入错误：

File "/usr/lib/python3.10/runpy.py", line 196, in _run_module_as_main
    return _run_code(code, main_globals, None,
  File "/usr/lib/python3.10/runpy.py", line 86, in _run_code
    exec(code, run_globals)
  File "/home/cc/Documents/informatics/QualCoder-master/qualcoder/__main__.py", line 47, in <module>
    from PyQt6 import QtCore, QtGui, QtWidgets
ImportError: libQt6Core.so.6: cannot open shared object file: No such file or directory

执行find / libQt6Core.so.6命令未找到该文件。

解决步骤

安装Qt6核心库文件
直接安装包含libQt6Core.so.6的系统包：
```
sudo apt update && sudo apt install qt6-base-dev
```
配置库加载路径
若安装后仍提示找不到文件，检查系统库路径配置：
1. 查看当前库路径：
```
echo $LD_LIBRARY_PATH
```
2. 临时添加Qt6库路径（仅当前终端会话生效）：
```
export LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu/:$LD_LIBRARY_PATH
```
3. 永久添加路径（重启后生效）：
  编辑~/.bashrc文件，添加上述export命令，然后执行：
```
source ~/.bashrc
```
统一PyQt6安装方式
若之前用pip安装了PyQt6，可能和系统Qt库冲突，建议切换为系统包安装：
1. 卸载pip版本的PyQt6：
```
pip uninstall PyQt6 PyQt6-Qt6 -y
```
2. 安装系统版本的PyQt6：
```
sudo apt install python3-pyqt6
```
修复损坏的Qt6依赖
若以上步骤无效，尝试重新安装Qt6基础库：
```
sudo apt install --reinstall qt6-base-libs
```