Ctrl + (反引号)是唯一能调出系统报错日志的快捷键,不是 Ctrl + ~ 或 Ctrl + Shift + ;按了没反应,大概率是输入法、远程工具或键盘软件在拦着它;最稳兜底方式是View → Show Console;插件print()和traceback需手动启用Tools → Developer → Log Console Messages才可见。

Ctrl + `(反引号)是唯一能调出系统报错日志的快捷键,不是 Ctrl + ~ 或 Ctrl + Shift + `;按了没反应,大概率是输入法、远程工具或键盘软件在拦着它。
Ctrl + ` 按不出来?先排查三个常见拦截点
绝大多数“打不开控制台”问题都卡在这三处:
- 你按的是
Ctrl + ~(带 Shift),而正确组合是Ctrl + `(不加 Shift)——` 和 ~ 是同一物理键,松开 Shift 再按才是对的 - 中文输入法(尤其是搜狗、微软拼音)处于激活状态,会吞掉该热键
- 远程桌面工具(如 TeamViewer、ToDesk)或键盘增强软件(如 PowerToys)已劫持
Ctrl + `
最稳的兜底方式:菜单栏点击 View → Show Console,它永远可用,底部出现 >>> 提示符才算真正就绪。
插件报错为什么看不到 traceback?必须手动开日志开关
Sublime 默认屏蔽所有插件的 print() 和异常输出——不是没发生,是通道关着。即使你写了 print("debug") 或代码真抛了 AttributeError,控制台也一片空白。
- 先确保控制台已打开(
Ctrl + `或菜单打开) - 触发一次插件行为(比如保存文件、执行命令)
- 仍无输出?进菜单 Tools → Developer → Log Console Messages,勾选它
勾选后,print()、sublime.status_message()、未捕获异常的红色 Traceback 全部实时刷出。注意:print() 不自动换行,建议写成 print("debug:", x, "\n") 避免日志挤成一团。
看到红色 Traceback 别跳过,最后一行就是关键线索
控制台顶部突然刷出红色堆栈,不是“编辑器卡了”,而是插件在加载或运行时真实出错。这是定位问题最快的方式,比翻文档高效得多:
-
ImportError: No module named 'requests':依赖缺失,或模块路径写错(比如目录名是utils.py却写了import Utils) -
AttributeError: 'NoneType' object has no attribute 'file_name':view为空却直接调用了.file_name(),没做判空 -
SyntaxError: invalid syntax:插件 Python 代码有语法错误,常发生在启动时
每条 Traceback 最后一行都精确标出文件路径和行号,例如 File "Packages/User/my_plugin.py", line 42,直接跳转就能改。
构建系统报错不跳转?file_regex 没配对,再准的正则也没用
双击错误行无法跳转,根本原因不是 Sublime “不支持”,而是构建输出没被识别——file_regex 再精准,也得匹配上实际输出格式才行。
- 先按
Ctrl + Shift + B调出原始构建日志,看有没有类似main.py:8: SyntaxError: invalid syntax这样含路径+行号的行 - 如果只有
error at line 5或Compilation failed这类无结构描述,file_regex再准也白搭,得改构建命令本身(比如 Python 用python -m py_compile,gcc 加-fshow-column) - 常见
file_regex示例:^File "(.+)", line ([0-9]+)(适配 Python 默认错误)、^(.+):([0-9]+):([0-9]+):(适配 gcc/flake8)
控制台不保存历史,关掉就丢;构建输出面板只是快照,不是实时流——真要看服务日志(比如 npm start 或 flask run),得用 Terminus 插件或系统终端,别指望 Sublime 自动转发。


















