ctrl + ` 是打开 sublime 控制台的唯一可靠方式,需松开 shift 按 tab 上方键触发反引号;控制台显示 >>> 即就绪,支持 print() 日志(需开启 log console messages)、sublime api 调用及插件重载,但不支持 shell 命令或外部 python 环境。

Ctrl + ` 是唯一可靠的打开方式,不是 Ctrl + ~
很多人按了没反应,其实是误按了 Ctrl + ~(波浪线),而 Sublime 要求的是不加 Shift 的 Ctrl + `(反引号),它和 ~ 在同一物理键位,但必须松开 Shift 才能触发。键盘上找不到 `?试试按一次不加 Shift 的 Tab 上方那个键——看到 ~ 就说明不加 Shift 就是 `。
- 菜单路径固定为
View → Show Console,不在 Tools 或 Developer 下 - 弹出后底部显示
>>>提示符,才代表真正就绪 - 再次按
Ctrl + `或按Esc可收起控制台 - 如果快捷键失效,大概率是输入法切换、远程桌面工具或系统级软件占用了该组合键
print() 没输出?先开日志开关,不是插件没跑
你在插件里写了 print("debug"),但控制台空空如也——这不是插件没执行,而是 Sublime 默认屏蔽了插件的 print() 输出。它只在你手动开启日志后才转发。
- 先确认控制台已打开:
Ctrl + ` - 再执行触发插件的操作(比如保存文件、调用命令)
- 若仍无输出,进菜单:
Tools → Developer → Log Console Messages,勾选它 - 勾选后,
print()、sublime.status_message()和未捕获异常都会实时刷出 - 注意:
print()不自动换行,建议写成print("var:", x, "\n")避免日志挤在一起
控制台不是终端,别指望它运行 shell 命令或 Python 脚本
控制台是 Sublime 内嵌的 Python 解释器沙盒,基于 Python 3.3+(具体取决于 Sublime 版本),但它**不等于系统终端**,也不支持 os.system()、subprocess 或读取外部 .py 文件。
- 可以安全调用 Sublime API:
sublime.version()、sublime.active_window().active_view().file_name() - 可重载插件:
sublime_plugin.reload_plugin("Git.Git")(注意引号和大小写) - 不能运行
pip install、python myscript.py或任何需要完整 Python 环境的代码 - 报错如
urllib.error.URLError通常指向网络代理或防火墙,不是控制台本身问题
启动报错 traceback 就在这里,别跳过红色堆栈
Sublime 启动时某个插件有 SyntaxError 或 ImportError,控制台顶部会立刻刷出红色 traceback——这不是干扰信息,而是定位问题的第一手线索。
- 常见错误:
ImportError: No module named 'xxx'、AttributeError: 'NoneType' object has no attribute 'xxx' - 每条 traceback 都带具体插件名和行号,直接去对应插件目录查
- 若看到
swallow_startup_errors相关提示(如 Anaconda 插件),可在Preferences → Package Settings → anaconda → Settings – User中添加:{"swallow_startup_errors": true} - 中文乱码、一闪而过、无法输入——这些是环境级小故障,控制台本身不处理编码,也不维护输入状态,只是 stdin/stdout/stderr 映射










