Sublime控制台是插件运行的Python沙盒,非日志查看器;默认屏蔽print()和错误输出,须手动勾选Tools→Developer→Log Console Messages才可见,且Ctrl+`需英文输入法下使用。

Sublime 控制台不是“日志查看器”,它本质是插件运行环境的 Python 解释器沙盒,错误日志(比如 ImportError、SyntaxError)和插件 print() 输出默认都不显示——必须手动开启转发开关,否则你看到的只是空面板。
Ctrl + ` 打不开?先确认按键和干扰项
Windows/Linux 下必须按 Ctrl + `(Tab 键正上方那个键,**不加 Shift**),macOS 是 Cmd + `。误按 Ctrl + ~ 或 Ctrl + Shift + ` 都无效。
- 中文输入法激活时,组合键常被吞掉——切到英文输入法再试
- 远程桌面(TeamViewer、ToDesk、RDP)、PowerToys、Logitech Options 等工具会劫持该热键
- 杀毒软件(如火绒、360)也可能拦截,临时退出可验证
- 最稳兜底操作:
View → Show Console,弹出后底部出现>>>提示符才算真正就绪
插件 print() 没输出?Log Console Messages 必须勾选
print("debug") 写了但控制台没反应,不是代码没执行,而是 Sublime 默认屏蔽所有插件 stdout。控制台不会自动捕获这些调用。
- 确保控制台已打开(
Ctrl + `或菜单打开) - 触发一次插件行为(比如保存文件、调用命令)
- 仍无输出?进菜单
Tools → Developer → Log Console Messages,勾选它 -
print()不自动换行,多条日志会挤成一行,建议写成print("debug:", var, "\n")
红色 traceback 是第一手线索,别关掉
控制台顶部突然刷出红色堆栈(Traceback),不是编辑器卡顿,而是插件在加载或运行时真实出错——它比任何文档都直接。
-
ImportError: No module named 'requests':依赖缺失或路径错误 -
AttributeError: 'NoneType' object has no attribute 'file_name':常见于未判空就调用view.file_name() -
UnicodeDecodeError:多因读取中文路径文件时未指定编码 - 关键信息永远在最后一行:
File "Packages/User/my_plugin.py", line 42,直接跳转修复即可
控制台不保存历史,关掉就丢;traceback 一闪而过,调试时务必第一时间截图或复制——尤其涉及启动期错误(比如插件加载失败),重启 Sublime 后这些痕迹就彻底没了。

















