Sublime运行Python GUI程序不显示窗口的根本原因是默认构建系统以非shell模式启动进程，导致GUI程序无法获取窗口句柄；解决方法是在.sublime-build文件中添加"shell": "true"配置。
Sublime 运行 Python GUI 程序（如 PyQt5、Tkinter）不显示窗口，根本原因不是代码或环境错了，而是默认构建系统用的是后台进程模式，GUI 窗口被静默拦截了。加 "shell": "true" 是最直接有效的解法。
为什么 Ctrl+B 运行 PyQt 代码没窗口，但任务管理器里有 python.exe？
这是因为 Sublime 默认用的是“非 shell 模式”启动进程：它把 Python 当作纯命令执行，不分配独立的 GUI shell 环境，Windows 下 GUI 程序（比如 QApplication.exec_()）就拿不到消息循环所需的窗口句柄，自然不弹窗——但主线程仍在跑，所以你能看到 python.exe 占着进程。
常见错误现象包括：
- PyQt/Tkinter 程序运行后无反应，控制台也无报错
- 程序末尾加了
input()或os.system("pause")也没用（它们只管控制台，不管 GUI） - 同一段代码在 CMD/PowerShell 里双击或命令行运行完全正常
怎么改构建系统才能让窗口弹出来？
必须编辑你当前使用的 .sublime-build 文件，在根对象里加一行 "shell": "true"（注意是字符串 "true"，不是布尔值 true），并确保它和其他字段之间有逗号分隔。
实操步骤：
- 菜单栏 →
Tools → Build System → New Build System，粘贴以下内容（以 Python 3 为例）：
{
"cmd": ["python", "-u", "$file"],
"file_regex": "^[ ]*File \"(*?)\", line ([0-9]*)",
"selector": "source.python",
"shell": "true"
}
- 保存为
Python3.sublime-build（路径自动落在Packages/User/下） - 再通过
Tools → Build System → Python3切换过去 - 按
Ctrl+B运行，窗口就会正常弹出
⚠️ 容易踩的坑：
- 写成
"shell": true（没引号）→ 构建系统加载失败，Ctrl+B 无声无息 - 写成
"shell": "True"或"shell": "1"→ 不生效，必须小写"true" - 改了文件但没切换构建系统 → 还在用旧的、没加
shell的配置
Mac/Linux 用户要注意什么？
macOS 上 "shell": "true" 同样有效，但部分 PyQt 应用（尤其 Qt6）可能还需额外设置环境变量 QT_QPA_PLATFORM=offscreen 才能避免崩溃；不过绝大多数 Tkinter / PyQt5 场景下，仅加 shell 就够了。
Linux 下如果仍不弹窗，优先检查是否启用了 Wayland（Sublime 在某些 Wayland 会话中对 GUI 程序支持不稳定），可临时切回 X11 测试。
另外，"shell": "true" 不影响标准输出重定向——print() 依然走 Sublime 控制台，GUI 窗口和控制台日志互不干扰。
控制台（Ctrl+`）里看不到 print()？先开日志开关
很多人以为加了 shell 就万事大吉，结果插件里写了 print("init")，控制台还是空的——这不是构建系统的问题，而是 Sublime 默认不捕获插件中的 print() 输出。
必须手动开启：Tools → Developer → Log Console Messages（勾选它）。勾上之后，所有插件里的 print()、sublime.status_message() 和未捕获异常都会实时刷到控制台。
顺带一提：input() 在控制台里永远卡死，别试；想调试交互逻辑，得用 SublimeREPL 或直接切终端。
真正容易被忽略的点是：这个 "shell": "true" 对所有 GUI 类型都起作用，不只是 PyQt —— Tkinter、matplotlib 的 plt.show()、甚至某些调用 os.startfile() 的脚本，都需要它。但反过来，它对纯 CLI 程序没副作用，所以建议所有 Python 构建系统都默认加上。
