Sublime Text 控制台是插件运行环境的输出通道,需手动开启Log Console Messages才能显示print();Ctrl+`打不开时应检查Shift键、输入法及远程工具干扰;红色traceback是插件错误第一手线索;实时日志需用Terminus插件。

Sublime Text 的控制台不是日志查看器,而是插件运行环境的输出通道;它默认不显示 print(),也不捕获构建命令的实时流——想看到插件调试信息或启动错误,必须手动开启日志开关并确认快捷键有效。
Ctrl + ` 打不开控制台?先检查这三个干扰项
绝大多数“打不开”问题都和快捷键误按或外部拦截有关:
- 键盘上按的是
Ctrl + ~(带 Shift)而不是Ctrl + `(不加 Shift),`和~是同一物理键,松开 Shift 才是正确触发方式 - 中文输入法处于激活状态(尤其是搜狗、微软拼音),会吞掉该组合键
- 远程桌面工具(如 ToDesk、TeamViewer)或键盘增强软件(如 PowerToys)已劫持
Ctrl + `
最稳的兜底操作:菜单栏点击 View → Show Console,它永远可用,且位置固定在底部,出现 >>> 提示符即表示就绪。
插件里写了 print() 却没输出?必须开 Log Console Messages
print() 在 Sublime 插件中默认静默,不是代码没执行,而是日志被屏蔽了。控制台本身不会自动转发这些调用。
- 先确保控制台已打开(
Ctrl + `或菜单打开) - 触发一次插件行为(比如保存文件、调用命令)
- 仍无输出?进菜单 Tools → Developer → Log Console Messages,勾选它
- 勾选后,所有
print()、sublime.status_message()和未捕获异常都会实时刷出
小提醒:print() 不自动换行,多条日志容易挤成一团,建议写成 print("debug:", var, "\n")。
看到红色 traceback 别关掉——那是定位问题的第一手线索
控制台顶部突然刷出红色堆栈(Traceback),不是编辑器卡顿,而是插件真出错了。它比任何文档都直接:
- 启动时报
SyntaxError或ImportError:说明插件文件有语法问题,或依赖模块缺失(比如ImportError: No module named 'requests') - 执行命令时报
AttributeError: 'NoneType' object has no attribute 'file_name':常见于没判空就调用view.file_name() - 中文路径导致
UnicodeDecodeError:多见于构建系统读取文件时未指定编码
别跳过 traceback 最后一行——那里明确写着错误类型、文件路径和行号,例如 File "Packages/User/my_plugin.py", line 42,直接跳转修复即可。
想看 npm 或 Python 服务的日志?别指望 Build 面板
Ctrl + B 调起的 Build 面板只是单次命令快照,它不支持输入、不能重试、看不到异步回调里的 console.log 或 print(),更无法持续监听。
- 需要实时滚动日志(如
npm run dev、flask run),装Terminus插件,按Ctrl + Shift + P输入Terminus: Open Default Shell in Panel,再运行命令 - 想盯住日志文件变化(如
app.log),用系统终端执行tail -f app.log,再把该文件拖进 Sublime 查看——简单、稳定、无兼容问题 - 构建系统配置不当会导致日志截断或编码错乱,尤其 Windows 下未设
"encoding": "cp936"时中文会变乱码
真正容易被忽略的是:控制台里能调用完整 Sublime API(如 sublime.active_window().active_view().file_name()),但它不是标准 Python 环境,不支持 input()、os.system() 或 pip 安装的第三方包——调试插件时得绕开这些限制。

















