PyQt6导入QtCore时DLL加载失败问题求助

问题场景 #

添加自动安装依赖的代码后，所有Qt程序运行均报错，执行以下导入代码：

from PyQt6.QtWidgets import QApplication, QMainWindow, QFileDialog
from PyQt6.QtGui import QColor
from PyQt6 import uic

触发错误：

from PyQt6 import QtCore ImportError: DLL load failed while importing QtCore:

自动安装依赖的代码如下：

import subprocess
import sys

def install_requirements():
    try:
        with open('requirements.txt', 'r') as f:
            requirements = f.read().splitlines()
        subprocess.check_call([sys.executable, '-m', 'pip', 'install', '--upgrade', *requirements])
    except Exception as e:
        print(f"Library instalation failed: {e}")

install_requirements()

解决方案 #

• 彻底卸载现有PyQt6相关包
  执行命令完全移除可能损坏的PyQt6组件：

  pip uninstall -y PyQt6 PyQt6-Qt6 PyQt6-sip
  

  检查是否卸载干净：

  • Windows：pip list | findstr PyQt
  • Linux/macOS：pip list | grep PyQt

• 清理残留文件
  找到Python的site-packages目录，手动删除所有包含PyQt6、QtCore的文件夹和文件，避免残留损坏文件影响重装。

  • Windows路径示例：C:\PythonXX\Lib\site-packages
  • macOS路径示例：~/Library/Python/X.Y/lib/python/site-packages
  • Linux路径示例：/usr/local/lib/pythonX.Y/site-packages

• 重新安装兼容版本的PyQt6
  直接通过pip安装官方适配版本，避免手动指定版本导致的兼容问题：

  pip install PyQt6
  

• 修复自动安装依赖的代码
  原代码的--upgrade参数会强制升级所有依赖，容易导致PyQt6被升级到与当前Python环境不兼容的版本，修改代码并锁定版本：
  修改后的安装代码：

  import subprocess
  import sys
  
  def install_requirements():
      try:
          with open('requirements.txt', 'r') as f:
              requirements = f.read().splitlines()
          # 仅安装缺失依赖，不强制升级已安装包
          subprocess.check_call([sys.executable, '-m', 'pip', 'install', *requirements])
      except Exception as e:
          print(f"Library installation failed: {e}")
  
  install_requirements()
  

  在requirements.txt中给PyQt6添加版本约束，例如：

  PyQt6~=6.5.0
  

  版本号可根据你的Python版本选择（Python 3.8+建议选择6.4及以上版本）。

• 检查Windows系统PATH环境变量
  确保Python的Scripts目录和PyQt6的Qt bin目录已加入系统PATH：

  • Qt bin目录通常在site-packages/PyQt6/Qt/bin，手动添加该路径到系统环境变量中，重启终端后再运行程序。

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