Sublime Text 4 上唯一可用、稳定且持续更新的终端插件是 Terminus；Terminal 插件因底层 API 移除（如 sublime_api 缺失）彻底失效，Package Control 已下架该包，手动安装易出错，必须通过 Package Control 安装 Terminus 并配置 "shell": "login" 和 "cwd": "${file_path:${folder}}"。
Sublime Text 4 上唯一能用、稳定、持续更新的终端插件只有 Terminus；Terminal 插件已彻底失效，装了也打不开，还会导致菜单灰显、快捷键失灵。
为什么 Terminal 插件在 ST4 上完全不能用
不是配置问题，是底层 API 被移除：ImportError: No module named 'sublime_api' 这类报错说明它调用的模块已在 ST4 中废弃。手动下载 ZIP、git clone 到 Packages/ 目录，大概率引发依赖缺失或 JSON 解析失败。Package Control 安装的 Terminal 包本身也不再维护，2026 年起所有主流渠道已下架。
别试兼容补丁，直接换 Terminus——它是目前唯一通过 ST4 官方 API 重构、支持真彩色、多标签、持久化历史的终端插件。
必须用 Package Control 安装 Terminus
手动放文件或第三方脚本安装会出问题，正确流程只有一条：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
Package Control: Install Package并回车 - 等待列表加载完成，搜索
Terminus（注意拼写，不是Terminal或SublimeTerminal） - 点击安装，完成即生效，无需重启 Sublime Text
如果还没装 Package Control，去官网复制最新安装脚本到控制台执行——别用旧版或镜像源，SHA256 校验已更新，过期脚本会报 hash 错误。
Shell 启动不加载环境变量？加 "shell": "login"
你在系统终端里能跑的 pnpm、python3、nvm，在 Terminus 里报 command not found，是因为它默认以非登录 shell 启动，不 source ~/.zshrc 或 ~/.bashrc。
解决方法：打开 Preferences → Package Settings → Terminus → Settings，在用户设置中加入：
{
"shell": "login"
}
平台差异要注意：
- Windows 用 Git Bash：填完整路径，如
"C:\Program Files\Git\bin\bash.exe"（反斜杠必须双写） - macOS：确认
/bin/zsh在 PATH 中；检查~/.zshrc是否有阻塞语句（比如卡在curl或sleep） - Linux：若报
exec: "sh": executable file not found in $PATH，这不是插件问题，是系统环境变量损坏，先修复$PATH
快捷键冲突和工作目录自动切换
Ctrl+Shift+T 默认是新建标签页，和终端冲突；Ctrl+` 更干净，推荐绑定：
[
{ "keys": ["ctrl+`"], "command": "terminus_open" }
]
想让终端自动进入当前文件所在目录？加 "cwd": "${file_path:${folder}}" 参数即可。但注意：${file_path} 在未保存文件时为空，此时会 fallback 到项目根目录或用户主目录。
复杂点在于：Terminus 的 cwd 是启动瞬间决定的，不会随编辑器焦点切换动态更新。如果需要“当前文件目录实时同步”，得配合 Terminus 的 send_text 命令 + 自定义插件监听 on_activated 事件——这属于进阶用法，多数人配好 cwd 和 shell 就够用了。
