必须使用 terminus 插件而非已停更的 terminal 类插件;安装须通过 package control;配置 working_dir 为 "${file_path}" 以确保终端在当前文件目录启动;快捷键冲突需手动绑定;windows 需指定 git bash 路径;shell 卡死多因配置文件中网络请求或初始化阻塞。

Sublime Text 本身不提供内置终端,所谓“Terminal”插件(如老版本的 SublimeTerminal)早已停止维护、不支持交互式操作(方向键失灵、Ctrl+C 无法中断、补全失效),**别装它,直接用 Terminus ——这是目前唯一稳定支持完整终端语义的方案。**
怎么装 Terminus 才不会出错
手动下载 zip 解压到 Packages/ 目录是最大误区:容易漏依赖、版本错乱、Windows 权限异常。必须全程走 Package Control:
- 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS)呼出命令面板 - 输入
Package Control: Install Package回车 - 等待列表加载完成,搜
Terminus(注意不是Terminal或SublimeTerminal) - 选中后回车安装;安装完无需重启,但部分系统(尤其 macOS)需重启 Sublime 才能识别 shell 路径
验证是否成功:再按 Ctrl+Shift+P 输入 Terminus: Open Default Shell in Panel,底部出现 $ 或 C:> 即表示就位。
为什么终端打开后不在当前文件目录
Terminus 默认工作目录是用户主目录(~),不是你正在编辑的文件夹。必须显式配置变量,否则 git status、npm start 全部报错“no such file”。
- 菜单栏 →
Preferences → Package Settings → Terminus → Settings - 在右侧用户设置中添加
default_config字段(注意逗号位置,JSON 格式要合法) - 关键字段是
working_dir,必须写成"${file_path}"(双引号包裹,大括号不能少) - 别写成
${file}(那是文件路径+名字)、也别硬编码成/home/user/project(失去通用性)
示例(Linux/macOS):
{
"default_config": {
"linux": {
"cmd": ["bash"],
"working_dir": "${file_path}"
},
"osx": {
"cmd": ["zsh"],
"working_dir": "${file_path}"
}
}
}
快捷键打不开终端?常见冲突和修复点
默认快捷键 Ctrl+Shift+T(Win/Linux)或 Cmd+Shift+T(macOS)常与“新建标签页”冲突,导致按了没反应。
- 进
Preferences → Key Bindings,右侧用户键位中添加自定义绑定,例如:{"keys": ["ctrl+`"], "command": "terminus_open"} - 如果用了
SideBarEnhancements插件想右键“在此处打开终端”,得额外配命令:terminus_open的args必须传"cwd": "${packages}"或动态取dir,原生不支持 - Windows 用户若用 Git Bash 却打不开,说明
Terminus没识别到它——得在配置里手动加shell_configs,指定cmd为["C:\Program Files\Git\bin\bash.exe"]
终端一执行命令就闪退或卡死怎么办
这不是插件 bug,而是 shell 启动时被阻塞。Terminus 启动的是非交互式 shell(--norc --noprofile 模式),但某些配置仍会触发副作用。
- 排查方法:用干净 shell 启动,例如在配置中临时改成
"cmd": ["/bin/bash", "--norc", "--noprofile"] - 常见罪魁祸首:
~/.bashrc里有curl请求、nvm加载慢、pyenv初始化卡住、PowerShell 的oh-my-posh主题渲染阻塞 - macOS 用户若用
zsh但终端空白,先检查/bin/zsh是否在$PATH,再看~/.zshrc有没有sleep或同步网络调用
真正难搞的从来不是装插件,而是 shell 配置和 Terminus 启动模式之间的隐式耦合——改一个 source 就可能让终端从秒开变成卡死十秒。











