ctrl + (windows/linux)或 cmd + (macos)是打开sublime text控制台的唯一推荐方式,它为嵌入式python解释器,可调用全部sublime api、捕获插件异常并实时显示日志。

Ctrl + ` 是唯一可靠打开方式,不是波浪线也不是 Shift 组合
Sublime Text 的控制台(Console)不是终端,也不是调试器,它是一个嵌入式的 Python 解释器环境,所有插件加载、命令日志、API 调用都走这里。打开它的**唯一推荐方式是 Ctrl + `(Windows/Linux)或 Cmd + `(macOS)**,注意这个 ` 是 Tab 键上方的反引号键,不加 Shift —— 很多人误按成 Ctrl + ~ 或 Ctrl + Shift + `,结果没反应。
- 键盘上找不到
`?试试按住 Shift 看是否输出~;若输出,那不加 Shift 就是` - 菜单路径固定为:
View → Show Console,不在 Tools 或 Developer 下 - 弹出后底部显示
>>>提示符,说明已就绪,可直接输入print("hello")测试 - 快捷键失效?大概率是输入法、远程工具或杀毒软件劫持了该组合键,此时用菜单是最稳的兜底方案
控制台不是 Python REPL,但能调用 Sublime API
它底层基于 Python(ST4 用的是 Python 3.3+),但不是标准 REPL:不能 import 系统模块(如 os.system)、不支持交互式调试、也不保存历史记录。但它能直接调用 Sublime 的全部公开 API,比如获取当前文件路径、触发命令、重载插件。
- 查当前文件:
sublime.active_window().active_view().file_name() - 查 Sublime 版本:
sublime.version() - 重载某个插件(如 Git):
sublime_plugin.reload_plugin("Git.Git")(注意引号和大小写) - 执行保存操作:
sublime.active_window().run_command("save") - 别写
input()——它会卡住,控制台不提供 stdin 交互能力
插件 print() 没输出?先开 Log Console Messages
你写了插件,在代码里加了 print("debug"),但控制台空空如也——这通常不是插件没运行,而是日志默认被屏蔽了。控制台本身不会自动捕获所有 print(),必须手动启用开关。
- 确认控制台已打开:
Ctrl + ` - 触发插件事件(比如保存文件、调用命令)
- 仍无输出?进菜单:
Tools → Developer → Log Console Messages,勾选它 - 勾选后,插件中所有
print()、sublime.status_message()和未捕获异常都会实时刷到控制台 -
print()不自动换行,建议写成print("debug:", var, "\n")避免多条日志挤在一起
报错 traceback 出现在这里,不是“卡了”,是真出错了
控制台最常被忽略的价值,是它会自动捕获并打印插件启动失败、语法错误、运行时异常的完整 traceback。这不是干扰信息,而是定位问题的第一手线索。
- Sublime 启动时若某个插件有
SyntaxError或导入失败,控制台顶部会立刻刷出红色堆栈 - 常见报错如:
ImportError: No module named 'xxx'、AttributeError: 'NoneType' object has no attribute 'xxx',都指向具体插件名和行号 - 看到
swallow_startup_errors相关提示(比如 Anaconda 插件报错),可在Preferences → Package Settings → anaconda → Settings – User中添加:{"swallow_startup_errors": true} - 网络类错误如
urllib.error.URLError,大概率是公司代理或防火墙拦截,换网络或配系统代理更有效,别硬改安装脚本








