Windows下PySide6应用报QT6WebEngineCore.dll缺失如何修复

• 基于PySide6开发的应用在Mac系统可正常运行
• Windows环境下编译/启动时弹出QT6WebEngineCore.dll未找到的报错
• 除Web查看器组件外，其余功能运行全部正常
• 报错截图：
  

Windows平台下PySide6的QtWebEngine相关组件属于体积较大的独立模块，默认安装、默认编译打包流程不会主动关联该模块的依赖文件：

1. 部分镜像源提供的PySide6安装包默认拆分了WebEngine组件，基础安装包不带对应dll
2. PyInstaller、Nuitka等打包工具的默认扫描规则不会主动收集WebEngine模块的隐式依赖，导致编译输出目录缺失对应动态链接库
3. 由于只有Web查看器组件依赖该dll，因此其余不调用WebEngine的功能完全不受影响，和实际故障表现完全匹配。

分两类场景处理：

源码直接运行时报错 #

1. 执行以下命令强制重装完整PySide6组件，避免安装精简阉割包：
   pip install --force-reinstall PySide6 PySide6-Addons PySide6-QtWebEngine
2. 安装完成后到当前Python环境的Lib\site-packages\PySide6路径下，确认存在QT6WebEngineCore.dll文件，再启动源码即可恢复正常。

编译为独立exe时报错 #

1. 如果使用PyInstaller打包，在原有打包命令后追加隐式导入参数，强制打包工具收集WebEngine相关模块：
   pyinstaller 你的项目入口文件.py --hidden-import PySide6.QtWebEngineCore --hidden-import PySide6.QtWebEngineWidgets
2. 如果执行完上述命令仍提示dll缺失，直接从PySide6安装目录中，把QT6WebEngineCore.dll、QT6WebEngineWidgets.dll、QT6WebEngineQuick.dll三个文件手动复制到编译输出的exe同级目录即可。
3. 额外注意：不要使用UPX压缩WebEngine相关dll，压缩会破坏dll的依赖结构和签名，反而会触发加载失败；另外WebEngine依赖VC++2019及以上版本运行库，目标运行设备需要提前安装对应运行库。

避坑提示：如果PySide6安装路径包含中文、特殊字符，也可能导致WebEngine模块的dll加载识别失败，安装和编译路径尽量使用纯英文路径。

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