Sublime Text 运行 PyQt5 失败主因是构建系统调用的 Python 解释器未安装 PyQt5，需手动配置 build system 指向正确环境并加 -u 参数启用无缓冲输出。
PyQt5 在 Sublime Text 里根本跑不起来？先确认 Python 环境没被绕晕
Sublime Text 本身不自带 Python 运行时，它只是调用你系统里已有的 python 或 python3。很多人配了半天 PyQt5，结果一运行就报 ModuleNotFoundError: No module named 'PyQt5'，其实不是 Sublime 的问题，而是它默认调用的 Python 解释器压根没装 PyQt5。
- 打开 Sublime →
Tools→Build System→New Build System… - 删掉默认内容，贴入以下（路径按你本地实际改）：
{ "cmd": ["C:/Users/xxx/AppData/Local/Programs/Python/Python39/python.exe", "-u", "$file"], "file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)", "selector": "source.python" } - 保存为
Python-PyQt5.sublime-build，再在Build System里选它 - 关键：这个
python.exe路径必须对应你用pip install PyQt5安装的那个环境（比如虚拟环境里的解释器，而不是系统 PATH 里的）
build system 里加 -u 参数不是可有可无
PyQt5 程序启动后通常会进入事件循环（app.exec_() 或 app.exec()），控制台输出容易被缓冲卡住，导致 Sublime 的 Build 窗口“假死”或不显示 print 日志。加 -u 是强制 Python 使用无缓冲输出，不然你连窗口弹没弹出来都得靠猜。
-
-u必须写在python.exe后面、$file前面，顺序错就无效 - 别试图用
sys.stdout.flush()补救——PyQt 的 GUI 线程和 stdout 不是一回事，治标不治本 - 如果你用的是 Anaconda 或 Miniconda，确保 build 文件里调用的是 conda 环境里的
python.exe，不是 base 环境的
PyQt5 导入失败的三个高频原因
就算 build system 指对了 Python，import PyQt5 仍可能失败，常见于 Windows 和多 Python 版本共存场景。
- 装了
PyQt6却在代码里写from PyQt5 import QtWidgets—— 版本混用直接报ImportError - 用了
pip install pyqt5-tools但没装核心包pip install PyQt5——pyqt5-tools只是 designer 和 uic 工具，不包含运行时 - Windows 上装了
PyQt5但 DLL 找不到：检查是否同时装了多个 Qt 运行时（比如 VS 自带的、MinGW 的、MSVC 的），冲突会导致ImportError: DLL load failed；临时解法是把PyQt5/Qt/bin加进系统PATH，但更稳的方式是重装干净环境
Sublime 里调试 PyQt5 界面几乎不可行
别指望 Sublime 自带的 Python 插件（如 SublimeCodeIntel 或 Anaconda）能跳转到 PyQt5 的信号/槽定义，也别想用断点单步跟 app.exec() 后的事件循环——Sublime 的构建系统本质是进程调用，没有调试器集成。
- 简单 print +
print(QApplication.instance())可验证 app 是否创建成功 - 复杂逻辑建议先拆出纯数据处理部分，在 Sublime 里跑通；GUI 部分单独用 PyCharm 或 VS Code 调试
- 如果非要在 Sublime 查 UI 问题，加一句
import sys; print(sys.path)确认 PyQt5 所在路径是否在搜索列表里
真正麻烦的从来不是配置那几行 JSON，而是你不知道 Sublime 的 build system 根本不参与 Python 模块解析过程——它只管扔命令过去，剩下的全靠你本地环境是否干净、路径是否指对、版本是否咬合。
