必须使用 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 就可能让终端从秒开变成卡死十秒。
