Ctrl + (Windows/Linux)或 Cmd + (macOS)是唯一有效打开方式,`为Tab键上方反引号键且不加Shift;误按Ctrl + ~等无效;失效时可用View → Show Console兜底;就绪标志为底部出现>>>提示符。

Ctrl + ` 是唯一有效的控制台打开方式,不是 Ctrl + ~
很多人按了没反应,是因为键盘上 ` 和 ~ 共用一个物理键位,但 Sublime 只认不加 Shift 的 Ctrl + `(Windows/Linux)或 Cmd + `(macOS)。误按 Ctrl + ~ 或 Ctrl + Shift + ` 完全无效。
键盘上找不到 `?试试按住 Shift 看是否输出 ~;如果是,松开 Shift 再按同一键就是正确触发键。
快捷键失效的常见原因包括:
- 中文输入法处于激活状态(必须切到英文输入法再试)
- 远程桌面工具(如 TeamViewer)或键盘驱动(如 Logitech Options)劫持了该组合键
- 杀毒软件拦截
- Preferences → Key Bindings 中用户自定义覆盖了默认绑定
最稳的兜底方案是菜单操作:View → Show Console。弹出后底部出现 >>> 提示符才算真正就绪,此时可输入 print("test") 验证。
插件报错堆栈全在控制台顶部,不在输出面板
点 Ctrl + B 编译后看到红色错误,双击无法跳转——那只是构建系统输出的快照;真正关键的异常 traceback(比如 ImportError: No module named 'xxx'、AttributeError: 'NoneType' object has no attribute 'xxx')全在控制台顶部实时刷出,并精确标出插件路径和行号,例如:plugins/MyPlugin/my_command.py 第 42 行。
这类错误不是“卡了”,而是 Sublime 启动时就捕获到的真实异常。典型线索包括:
- 堆栈第一行含
File "./Packages/xxx/...→ 直接定位问题插件 - 出现
create_connection→ 插件误用了标准库网络函数 - 含
ssl、certifi、urlopen→ Package Control 自身网络层失败 - 末尾是
NoneType is not callable→ 回调函数被删或未定义
print() 默认不输出,必须手动开启日志转发
你在插件里写了 print("debug"),控制台却空空如也,这不是插件没运行,而是 Sublime 默认屏蔽所有插件的 print() 输出。它只在你启用日志转发后才把内容刷出来。
操作步骤:
- 先确认控制台已打开:
Ctrl + ` - 触发插件动作(比如保存文件、调用命令)
- 仍无输出?进菜单:
Tools → Developer → Log Console Messages,勾选它
注意:print() 不自动换行,多条日志会挤成一行,建议写成 print("var:", x, "\n")。
插件被静默忽略时,控制台安静如鸡
插件装上了但命令面板搜不到、快捷键无效、控制台没日志——很可能它已被 Sublime 自动加入 ignored_packages 列表,彻底跳过加载。这不是配置错了,是启动时因签名异常、结构不全或 API 版本不匹配被主动屏蔽。
排查方法:
- 打开控制台,搜索
ignored_packages或disabled packages - 检查
Preferences → Settings – User中是否有"ignored_packages"字段,手动移除对应插件名 - 禁用插件务必走
Preferences → Package Control → Disable Package,禁用后必须重启 Sublime 才生效
别依赖控制台长期驻留——它不保存历史,关掉就丢;调试时看到关键堆栈就得立刻截图或复制,否则一刷新就没了。

















