VSCode中PySide6/PyQt5报错主因是编辑器与终端Python解释器不一致，需通过“Python: Select Interpreter”统一选择含库的环境，并验证终端路径及工具链路径（如pyside6-designer.exe），UI文件编译后须用组合继承调用setupUi，且app.exec()必须在主线程唯一调用。
VSCode 终端和编辑器必须用同一个 Python 解释器
很多人执行 pip install PySide6 成功了，但 VSCode 里一运行就报 ModuleNotFoundError: No module named 'PySide6'，或者 QApplication 初始化就崩溃——根本不是库没装，而是 VSCode 的编辑器和终端用了不同 Python 环境。
必须手动对齐：
- 按
Ctrl+Shift+P，输入Python: Select Interpreter，选中你装了PySide6或PyQt5的那个环境（比如.venv\Scripts\python.exe） - 打开集成终端（
Ctrl+`），立刻运行：python -c "from PySide6.QtWidgets import QApplication; print('OK')"（PyQt5 则用from PyQt5.QtWidgets import QApplication） - 如果没输出
OK，检查终端左下角是否显示了刚选中的解释器路径；没显示就关掉终端重开一个
PYQT Integration 插件的三个关键路径必须填对
这个插件本身不带工具，只负责调用你本地已安装的 pyside6-uic、pyside6-designer、pyside6-rcc（PyQt5 对应是 pyuic5、designer、pyrcc5）。路径错一个，右键编译或打开设计器就静默失败。
典型路径（Windows + 虚拟环境）：
-
pyside6-uic.exe：一般在.venv\Scripts\pyside6-uic.exe -
pyside6-designer.exe：也在.venv\Scripts\下，不是Lib/site-packages/PySide6/里的那个designer.exe（那是 Qt 官方二进制，不兼容 PySide6 工具链） -
pyside6-rcc.exe：同在.venv\Scripts\
验证方式：在终端里直接运行 pyside6-designer，能弹出界面才算路径有效。
UI 文件编译后不能直接当窗口类用
用插件右键 Compile UI File 生成的 ui_main.py 只含一个 Ui_MainWindow 类，它没有继承 QMainWindow，也不调用 setupUi。直接实例化会报错或黑屏。
正确用法是组合继承：
from PySide6.QtWidgets import QMainWindow from ui_main import Ui_MainWindow <p>class MainWindow(QMainWindow, Ui_MainWindow): def <strong>init</strong>(self): super().<strong>init</strong>() self.setupUi(self) # 必须显式调用
注意点：
- 别漏掉
self.setupUi(self)，这是连接 UI 和逻辑的核心步骤 - PyQt5 用户注意：用
app.exec_()；PySide6 必须用app.exec()，写错会导致程序立即退出 - 确保脚本末尾只有
app.exec()，且不在函数内、不在条件分支里
调试 GUI 程序时窗口一闪而逝？不是代码问题，是启动方式不对
VSCode 默认用 python xxx.py 执行，但 GUI 程序需要事件循环持续阻塞主线程。app.exec() 之后如果脚本结束，进程就退出，窗口自然消失。
两种可靠方案：
- 在
launch.json中加配置："console": "integratedTerminal"，让调试器走终端而不是内部输出 - 更简单：直接按
F5启动调试，VSCode 会自动附加调试器并保持进程存活；不要用右上角绿色三角形“运行”按钮
如果仍闪退，检查是否误把 app.exec() 写在了 if __name__ == '__main__': 外面，或被异常提前中断——加个 try/except 包住整个 GUI 初始化块，打印异常再退出。
最易被忽略的是：PySide6 的 QApplication 构造必须在主线程，且全局只能有一个实例。多线程中创建、重复初始化、或在子线程里调用，都会导致黑屏或崩溃，这类错误不会抛出明显异常，只会静默失败。
