ctrl + 打不开控制台?先确认按键和输入法:windows/linux 下必须按 ctrl + (tab 键正上方反引号键,不加 shift),macos 用 cmd + ;误按 ctrl + ~ 或 ctrl + shift + 无效;中文输入法激活会吞快捷键,需切英文;远程工具或杀毒软件可能劫持,最稳兜底是 view → show console,底部出现 >>> 才算就绪。

Ctrl + ` 打不开控制台?先确认按键和输入法
Windows/Linux 下必须按 Ctrl + `(Tab 键正上方的反引号键,不加 Shift),macOS 是 Cmd + `。很多人实际按的是 Ctrl + ~ 或 Ctrl + Shift + `,这两个组合完全无效。
键盘上找不到 `?试试按一次 Tab 上方那个键:如果输出 ~,松开 Shift 再按同一键就是正确触发键;如果直接输出 · 或其他符号,说明中文输入法处于激活状态——切到英文输入法再试。
常见干扰项包括:
- 远程桌面(TeamViewer、RDP)、Logitech Options、Razer Synapse 等工具劫持该热键
- 杀毒软件(如火绒、360)拦截快捷键
- Preferences → Key Bindings 中用户自定义覆盖了默认绑定
最稳兜底操作:View → Show Console。弹出后底部出现 >>> 提示符才算真正就绪,此时可输 print("test") 验证解释器是否活。
插件报错堆栈为什么不在输出面板,而在控制台顶部?
点 Ctrl + B 编译后看到的红色错误块只是构建系统的快照,双击无法跳转源码;而真正影响插件行为的异常——比如 ImportError: No module named 'xxx'、AttributeError: 'NoneType' object has no attribute 'file_name'——全在控制台顶部实时刷出,带完整 traceback 和精确路径行号,例如 plugins/MyPlugin/my_command.py 第 42 行。
这类错误不是“卡了”,是 Sublime 启动或加载插件时就捕获到的真实 Python 异常。典型线索包括:
- 堆栈第一行含
File "./Packages/xxx/→ 直接定位问题插件 - 出现
create_connection→ 插件误用了标准库网络函数 - 含
ssl、certifi、urlopen→ Package Control 自身网络层失败 - 末尾是
NoneType is not callable→ 回调函数被删或未定义
print() 写了但控制台没输出?Log Console Messages 必须手动勾选
你在插件里写了 print("debug"),控制台却空空如也——这不是插件没运行,而是 Sublime 默认屏蔽所有插件的 print() 输出。它只在你启用日志转发后才把内容刷出来。
操作路径:Tools → Developer → Log Console Messages,勾选它。之后以下内容都会实时出现:
- 插件中的
print()调用 -
sublime.status_message()提示 - 未捕获异常的红色 traceback
注意:print() 不自动换行,多条日志会挤成一行。建议写成 print("debug:", var, "\n") 或 print(f"line {line_num}: {value}"),避免信息糊在一起。
控制台不保存历史,traceback 一闪而过就得立刻处理
控制台不记录历史,关掉就丢。尤其启动期错误(比如插件加载失败、语法错误)只在首次启动时刷一次,重启 Sublime 后痕迹彻底消失。
看到红色 traceback 别跳过,那是最该盯住的第一手线索。最后一行永远最关键:File "Packages/User/my_plugin.py", line 42 —— 直接跳转修改即可。调试时务必第一时间截图或复制,别等刷新后再找。
有些插件(如 Anaconda)会主动吞掉错误,显示 swallow_startup_errors 相关提示。这时需进 Preferences → Package Settings → [插件名] → Settings – User,手动加 {"swallow_startup_errors": true} 才能暴露真实异常。











