PySide2基础环境启动报错：求无法加载Windows平台插件的原因与解法

报错原因 #

• 基础环境存在Qt依赖冲突：基础环境中可能预装了PyQt5/PyQt6、其他版本的PySide等Qt相关库，这些库自带的Qt组件和PySide2的Qt版本不兼容，导致插件加载时出现冲突——虽然能找到"windows"插件，但无法正常初始化。
• 环境变量干扰：系统或基础环境的QT_QPA_PLATFORM_PLUGIN_PATH环境变量被错误配置，指向了非PySide2的Qt插件目录，导致加载了不匹配的插件文件。
• 安装文件损坏：基础环境中PySide2的platform插件文件可能在安装时损坏，或因权限问题无法被读取，而虚拟环境是全新安装，文件完整无损坏。

修复方法 #

方法1：清理冲突依赖后重新安装 #

先卸载基础环境中所有Qt相关的Python包，再重新安装PySide2：

pip uninstall -y PyQt5 PyQt6 PySide PySide6 PySide2
pip install PySide2

方法2：手动指定插件路径 #

在测试代码最开头添加环境变量设置，强制使用PySide2自带的平台插件：

import os
from PySide2 import QtCore
# 指定PySide2自带的platform插件目录
os.environ['QT_QPA_PLATFORM_PLUGIN_PATH'] = os.path.join(os.path.dirname(QtCore.__file__), 'plugins', 'platforms')

# 之后再导入其他PySide2模块
from PySide2.QtWidgets import (QApplication, QLabel, QVBoxLayout, QPushButton,
                               QWidget, QGridLayout, QTabWidget, QListWidget,
                               QListWidgetItem, QCheckBox, QHBoxLayout,
                               QLineEdit, QDialog, QMessageBox,
                               QStyle, QStyleOption, QStylePainter,
                               QStackedWidget, QScrollArea, QComboBox,
                               QDoubleSpinBox)
from PySide2 import QtWidgets
from PySide2.QtCore import QRect, QPoint, QSettings, QSize, QProcess, Qt

# 原窗口类代码
class Window(QWidget):
    def __init__(self):
        super().__init__()

        self.setStyleSheet('''
        ''')

        self.setWindowTitle('Some title')

        self.screen = QApplication.primaryScreen()
        rect = QRect(QPoint(), self.screen.size() * 0.9)
        rect.moveCenter(self.screen.geometry().center())

        self.setGeometry(rect)


if __name__ == '__main__':
    import sys
    app = QApplication(sys.argv)
    window = Window()
    window.show()
    sys.exit(app.exec_())

方法3：修复PySide2安装文件 #

完全卸载PySide2后，手动清理残留文件，再重新安装：

1. 执行pip uninstall -y PySide2
2. 找到Python基础环境的Lib/site-packages目录，删除所有PySide2相关的文件夹和文件
3. 重新执行pip install PySide2

方法4：检查系统环境变量 #

查看系统环境变量中是否存在QT_QPA_PLATFORM_PLUGIN_PATH，如果有：

• 临时删除该环境变量，再运行测试代码
• 或者将其值修改为PySide2自带的platform插件目录（路径参考方法2中的路径）

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