VSCode 完整支撑 PySide6 开发需三路径对齐：Python 解释器、pyside6-designer（或 macOS 的 Designer.app/Contents/MacOS/Designer）、pyside6-uic；任一错位将导致黑屏/崩溃/找不到 designer，且必须硬编码绝对路径至 .vscode/settings.json。
VSCode 能完整支撑 PySide6 图形开发，但关键不在装插件，而在三处路径对齐：Python 解释器、pyside6-designer.exe（或 macOS 的 Designer.app）、pyside6-uic。任一错位，就会出现“能 import 不报错，但一运行就黑屏/崩溃/找不到 designer”。
确认 VSCode 正在用对的 Python 解释器跑 PySide6
很多人卡在 ModuleNotFoundError: No module named 'PySide6'，其实不是没装，而是 VSCode 编辑器和终端用了两个不同环境。
- 按
Ctrl+Shift+P输入Python: Select Interpreter，选中你pip install PySide6那个环境（比如.venvScriptspython.exe或~/miniforge3/envs/pyside-env/bin/python） - 打开集成终端（
Ctrl+`），立刻运行：python -c "from PySide6.QtWidgets import QApplication; print('OK')" - 必须输出
OK；如果报错，先看终端左下角是否显示你刚选的解释器路径——不显示就关掉终端重开一个，别急着重装
Windows/macOS 下定位并硬编码 pyside6-designer 路径
pyside6-designer.exe（Windows）或 Designer.app/Contents/MacOS/Designer（macOS）不是独立软件，它随 PySide6 安装进当前 Python 环境的 site-packages 里。系统 PATH 里的旧版本、中文用户名路径、空格都会让它“消失”。
- 在已激活的 VSCode 终端中运行：
python -c "import PySide6; print(PySide6.__path__[0])"，得到类似C:devmyapp.venvLibsite-packagesPySide6的路径 - Windows：拼出完整路径
C:devmyapp.venvScriptspyside6-designer.exe - macOS：拼出
/path/to/PySide6/Designer.app/Contents/MacOS/Designer（注意是Designer可执行文件，不是Designer.app文件夹） - 把路径写进项目级
.vscode/settings.json："qtforpython.designer.path": "你的完整路径"
让 .ui 文件保存时自动转成 ui_*.py
手动敲 pyside6-uic main.ui -o ui_main.py 很快就会烦。VSCode 的 Qt for Python 扩展支持自动编译，但必须指定 pyside6-uic 路径，且不能依赖系统 PATH。
- 同样用
python -c "import PySide6; print(PySide6.__path__[0])"找到 PySide6 根目录，然后 Windows 拼..\Scripts\pyside6-uic.exe，macOS 拼../uic - 在
.vscode/settings.json中补全："qtforpython.uic.path": "你的完整路径" - 启用设置：
"qtforpython.autoCompileUi": true，保存.ui文件时会自动生成同名ui_*.py - 生成的
ui_main.py只含Ui_MainWindow类，实际使用仍需继承 + 调用self.setupUi(self)，别直接实例化它
运行 GUI 窗口一闪而逝？不是代码问题，是启动方式错了
VSCode 默认用 python xxx.py 运行脚本，没有交互式阻塞，事件循环一结束进程就退出。这不是逻辑错误，是执行上下文缺失。
- 确保入口脚本末尾是：
sys.exit(app.exec())（不是app.exec()单独一行） - 不要右键“Run Python File in Terminal”，改用 VSCode 的调试模式（
F5）或终端手动运行：python main.py - 若仍闪退，加一句
input("Press Enter to exit...")在sys.exit()前临时排查——大概率是QApplication初始化失败（比如解释器没对齐）
最常被忽略的是：macOS 上 Designer.app 的可执行路径必须指向 Contents/MacOS/Designer，而不是 Designer.app 文件夹本身；Windows 用户容易把 Scripts 目录错当成 site-packagesPySide6 目录去拼路径。工具链路径一旦写死在 settings.json 里，就别再指望系统 PATH 自动兜底。
