sublime text 本身无系统终端,ctrl+`打开的是仅支持python代码和sublime api的console沙盒,不识别ls、git等shell命令;需安装terminus插件并通过快捷键调用真正终端。

Sublime Text 本身没有“系统运行控制台”——它不执行代码,也不托管 Python/Node/Java 进程,所谓“运行输出”全靠外部构建系统或插件转发。你真正需要的,是区分清楚三个完全不同的东西:Console(插件日志与 API 沙盒)、Build Results(Ctrl + B 的单次命令快照)、Terminus(真正的终端面板)。
Ctrl + ` 打开的是 Console,不是终端
Ctrl + `(Windows/Linux)或 Cmd + `(macOS)打开的 Console 是 Sublime 内嵌的 Python 解释器沙盒,只认 Python 语法和 Sublime API,比如:
sublime.active_window().folders() sublime.version()
它不支持 ls、git status、python main.py 等任何 shell 命令。误以为它是终端,是调试卡住的第一大原因。
- 键盘上按
Shift + `输出~?那松开Shift再按同一键才是正确触发 - 中文输入法激活时,
Ctrl + `必定失效;切英文再试 - 远程桌面(TeamViewer/RDP)、Logitech Options、火绒等工具会劫持该快捷键
- 最稳兜底:菜单
View → Show Console,底部出现>>>才算就绪
Ctrl + B 输出的是 Build Results,不是实时日志
点 Ctrl + B 后看到的红色错误块,只是构建系统(如 Python.sublime-build)执行完 python -u "$file" 后的**一次性 stdout/stderr 快照**。它不带 traceback 行号跳转,也不保留上下文。
- 双击错误行无法跳转?正常——构建输出不解析源码路径
- 想看真实异常堆栈(比如
ImportError: No module named 'requests'),必须看Console顶部实时刷出的红色 traceback - 构建系统配置路径在
Tools → Build System → New Build System...,和Console完全无关
要跑命令,得装 Terminus 插件
Sublime 默认不提供终端能力。真要执行 git commit、npm run dev 或交互式 python,必须安装 Terminus:
- 用
Package Control安装Terminus(先确保Console能打开,再粘贴安装命令) - 启动终端:
Ctrl + Shift + P→ 输入Terminus: Open Default Shell in Panel - 它能复用系统 shell(cmd/powershell/zsh/bash),支持分屏、历史滚动、Ctrl + C 中断
- 别试图用
Console替代它——两者底层机制完全不同
插件 print() 不显示?Log Console Messages 必须手动开
你在插件里写了 print("debug"),但 Console 一片空白?这不是代码没跑,是 Sublime 默认屏蔽所有插件的 print() 输出。
- 先确认
Console已打开(Ctrl + `,底部有>>>) - 菜单走
Tools → Developer → Log Console Messages,勾选它 - 之后插件中所有
print()、sublime.status_message()、未捕获异常都会实时刷到Console顶部 -
print()不自动换行,多条日志会挤成一行,建议写成print("key:", value, "\n")
最易被忽略的一点:Console 不保存历史,关掉就丢。看到关键 traceback(比如指向 plugins/MyPlugin/my_command.py 第 42 行)后,立刻复制或截图——等刷新后再找,已经没了。











