ctrl + ` 是打开 sublime 控制台的唯一有效方式，弹出的是嵌入式 python 解释器沙盒，支持 api 调用和报错 traceback 查看，但不执行 shell 命令；print() 输出需手动启用 tools → developer → log console messages。
Ctrl + ` 是打开 Sublime 控制台的唯一有效方式，不是 Ctrl + ~，也不是任何 Shift 组合。它弹出的是嵌入式 Python 解释器，不是终端、不是浏览器 DevTools、更不执行 shell 命令。
为什么按 Ctrl + ` 没反应？
绝大多数情况是物理按键按错或环境干扰：
- 键盘上那个键和
~共用位置：按住Shift输出~，松开Shift再按同一键才是` - 中文输入法处于激活状态时，快捷键会被拦截
- 远程桌面（如 RDP、TeamViewer）或杀毒软件常劫持该组合键
-
Ctrl + ~或Ctrl + Shift + `完全无效，Sublime 不识别
最稳兜底方案：菜单栏点击 View → Show Console（注意不是 Tools 或 Developer 下）；弹出后底部出现 >>> 提示符，才表示解释器已就绪。
print() 为什么插件里写了却看不到输出？
不是插件没运行，是 Sublime 默认屏蔽所有插件的 print() 输出——控制台不会自动捕获 stdout。
- 先确保控制台已打开且有
>>>提示符 - 触发插件行为（比如保存文件、调用命令面板里的某个命令）
- 仍无输出？进菜单
Tools → Developer → Log Console Messages，勾选它 - 勾选后，插件中所有
print()、sublime.status_message()和未捕获异常都会实时刷出 -
print()不自动换行，多条日志会挤成一行；建议写成print("debug:", x, "\n")
控制台能干什么？哪些操作会失败？
它是 Python 沙盒，支持 Sublime 全量公开 API，但有明确边界：
- ✅ 可执行：
sublime.version()、sublime.active_window().active_view().file_name()、sublime_plugin.reload_plugin("Git.Git") - ✅ 可调试：插件启动失败、语法错误、运行时异常的完整
traceback都在这里实时打印，带精确路径和行号 - ❌ 不支持：
input()（会卡住）、os.system()、subprocess、任何 shell 命令（如ls、git） - ❌ 不保存历史：关掉控制台，所有输出即丢失；别指望它长期驻留日志
- ❌ 不等价于终端：想跑命令必须装
Terminus插件，且需单独配置快捷键
常见误判：报错是“卡了”还是真出错了？
看到红色 traceback 别慌，那不是界面卡死，而是 Sublime 在启动或运行时捕获到的真实异常。比如：
-
ImportError: No module named 'xxx'—— 插件依赖缺失或路径错误 -
AttributeError: 'NoneType' object has no attribute 'xxx'—— 某个 API 调用返回了None，后续链式调用崩了 -
swallow_startup_errors相关提示 —— 某些插件（如 Anaconda）默认吞掉启动错误，需手动在用户设置里加{"swallow_startup_errors": true}
这些 traceback 出现在控制台顶部，不是构建输出面板里；双击无法跳转，但行号和文件路径是准确的——这是你定位问题的第一手线索，不是噪音。
