必须确保VSCode终端与编辑器使用同一Python解释器：通过“Python: Select Interpreter”选择含PySide6的环境，并在集成终端运行python -c "from PySide6.QtWidgets import QApplication; print('OK')"验证，输出OK才表示路径对齐成功。
VSCode能直接运行PySide6 GUI程序，但必须确保Python解释器、PySide6库、Qt工具链三者路径对齐，否则import PySide6不报错，QApplication一执行就崩溃或黑屏。
如何确认VSCode正在用对的Python环境跑PySide6
很多人卡在“明明pip install成功了，却提示ModuleNotFoundError: No module named 'PySide6'”，本质是VSCode终端和编辑器用的不是同一个Python解释器。
- 在VSCode中按
Ctrl+Shift+P，输入“Python: Select Interpreter”，选中你装了PySide6的那个环境（比如.venvScriptspython.exe） - 打开集成终端（
Ctrl+`），运行：python -c "from PySide6.QtWidgets import QApplication; print('OK')"—— 必须输出OK才算真正打通 - 如果报错，别急着重装，先检查终端左下角是否显示了你刚选中的解释器路径；没显示就说明终端没同步，关掉再开一个
为什么Qt Designer打不开？常见路径陷阱
pyside6-designer.exe不是独立安装的软件，它随PySide6一起被pip安装进Python环境的Scripts/目录里。Windows下常因路径含空格或Unicode字符（比如中文用户名）导致VSCode找不到它。
- 不要依赖
where pyside6-designer——它可能返回系统PATH里的旧版本，而非当前虚拟环境的 - 手动查真实路径：在已激活的VSCode终端中运行
python -c "import PySide6; print(PySide6.__file__)"，把输出路径的__init__.py替换成..Scriptspyside6-designer.exe - 在
.vscode/settings.json里硬编码路径，例如："qtForPython.designer.path": "C:\dev\myapp\.venv\Scripts\pyside6-designer.exe"
UI文件（.ui）怎么变成可运行的Python类
不能手写uic.loadUi()去动态加载，那样调试困难、IDE无补全；推荐生成静态Python模块，让VSCode能跳转、补全、类型推导。
立即学习“Python免费学习笔记（深入）”；
- 用命令行转换：
pyside6-uic main_window.ui -o ui_main.py - 更省事的是配VSCode任务：在
.vscode/tasks.json里加一个uic任务，绑定快捷键（如Ctrl+Alt+U），保存.ui时自动更新对应.py - 生成的
ui_main.py里只有Ui_MainWindow类，实际使用时仍需继承+setupUi，别把它当完整窗口类直接实例化
运行GUI时窗口一闪而逝或报错“QApplication was not created”
这不是代码逻辑问题，而是VSCode默认用python命令运行脚本，没加-i且没阻塞事件循环。PySide6要求app.exec()必须在主线程调用并保持阻塞。
- 确保入口脚本末尾有且仅有：
app.exec()（不是app.exec_()，那是PyQt的老写法） - 别在Jupyter或Python交互模式下运行GUI，它们会抢占主线程控制权
- 如果用VSCode调试器启动，需在
launch.json中设置"console": "integratedTerminal"，否则GUI线程会被后台进程干扰
最易忽略的一点：PySide6的QApplication构造函数必须在所有其他Qt对象创建前调用，且整个进程中只能有一个实例。如果你在模块导入阶段就初始化了app，或者在多个文件里各自new了一个app，后续任何QWidget都会静默失败——连错误日志都不抛，只留个空窗口或直接退出。
