terminus是唯一能稳定支持交互式终端会话的sublime text第三方插件,需通过package control安装,依赖系统已有shell(如bash、pwsh),配置cwd参数可实现在当前文件或项目目录启动,ctrl+c失效需绑定terminus_send_key命令,中文乱码需调整locale环境变量。

Terminus 是唯一能跑出真终端的插件,别装错
Sublime Text 本身没有内置终端,所谓“集成终端”全靠第三方插件实现。目前只有 Terminus 能稳定支持交互式会话——方向键、Ctrl+C 中断、命令补全、多标签、分屏都可用。老插件如 SublimeTerminal 或 ShellCommand 已停止维护,ST4 下大概率报 ImportError: No module named 'sublime_plugin' 或根本无法响应输入。
安装只有一条路径:打开命令面板(Ctrl+Shift+P / Cmd+Shift+P),输 Package Control: Install Package → 回车 → 搜 Terminus → 点击安装。装完不用重启,但若控制台(Ctrl+`)里看不到 Terminus: Open Default Shell in Panel 命令,说明加载失败,常见原因是 Package Control 下载中断,删掉 Packages/Terminus/ 目录重装即可。
shell 找不到或一打开就闪退?先查 PATH 和 shell 初始化
Terminus 不自带 shell,它调用的是你系统里已有的 bash、zsh、pwsh 或 cmd.exe。所以报 Unable to find shell 或空白/卡死,90% 是 shell 本身有问题。
- Windows 用户如果用 Git Bash,得手动在
Preferences → Package Settings → Terminus → Settings里加shell_configs,否则默认只认cmd和powershell - macOS 用户若用
zsh却打不开,先确认/bin/zsh在系统PATH里;再检查~/.zshrc是否有阻塞语句(比如curl https://xxx超时卡住) - Linux 下报
exec: "sh": executable file not found in $PATH,不是插件问题,是环境变量异常——检查$PATH是否被清空或覆盖
验证方法:用干净 shell 启动测试,比如在快捷键配置里写:{"cmd": ["/bin/bash", "--norc", "--noprofile"]}。能跑通,说明问题出在你的 shell 配置文件里。
快捷键唤出终端却不在当前项目目录?必须传 cwd
直接绑定 {"command": "terminus_open"} 而不带参数,终端大概率打开在 Sublime 启动时的工作目录(通常是用户主目录),而不是你正在编辑的文件位置。
正确做法是在快捷键配置中指定 cwd 参数:
[{"keys": ["ctrl+alt+t"], "command": "terminus_open", "args": {"cwd": "${file_path:${folder}}"}}]
这个表达式含义是:有文件打开时取其所在目录(${file_path}),没文件时退回到当前项目根目录(${folder})。别硬写绝对路径,也别信 ${project_path} —— 它在单文件模式下为空,会导致终端启动失败。
Ctrl+C 失效或中文乱码?改键位绑定和编码设置
Ctrl+C 在 Terminus 里默认可能被 Sublime 全局快捷键拦截(比如触发“复制”动作),导致无法向进程发中断信号。解决办法是显式绑定终端专属快捷键:
[{"keys": ["ctrl+c"], "command": "terminus_send_key", "args": {"key": "c", "ctrl": true}, "context": [{"key": "terminus.focus"}]}]
中文乱码通常是因为 shell 启动时未正确加载 locale,可在 Terminus 设置里加:
"default_config": {
"env": {"LANG": "zh_CN.UTF-8", "LC_ALL": "zh_CN.UTF-8"}
}
注意:Windows 的 cmd.exe 默认用 GBK 编码,强行设 UTF-8 可能出问题,建议换用 pwsh 或 git-bash。
真正麻烦的从来不是装插件,而是 shell 初始化逻辑和 Sublime 的非交互式启动模式之间的冲突——很多 .zshrc 或 .bash_profile 里的诊断命令、网络请求、环境检测,在 Terminus 启动时都会执行一遍,而它不等你按回车就直接卡住。最稳的做法,永远是先用 --norc --noprofile 启动验证基础功能,再逐步放开配置。











