Sublime Text 4 唯一可用终端插件是 Terminus，必须通过 Package Control 安装；Terminal 插件因 API 移除已彻底失效，强行安装会导致无响应、菜单灰显、快捷键失灵；Terminus 需配置 "shell": "login" 解决环境变量问题，快捷键建议设为 Ctrl+` 并指定 cwd 参数。
Sublime Text 本身没有内置终端，装 Terminal 插件在 ST4 上根本跑不起来——它已彻底失效。唯一能用、还在持续更新的只有 Terminus，而且必须通过 Package Control 安装，手动放文件或 GitHub clone 都会出问题。
为什么 Terminal 插件在 Sublime Text 4 上打不开
不是你配置错了，是插件底层被官方废弃了：ImportError: No module named 'sublime_api' 这类报错说明它调用的 API 已从 ST4 移除。哪怕强行装上，也会无响应、右键菜单灰掉、快捷键失灵。别折腾兼容补丁，直接换 Terminus。
安装 Terminus 必须走 Package Control
手动下载 ZIP 或 git clone 到 Packages/ 目录会导致依赖缺失、权限异常、JSON 解析失败等问题。正确路径只有一条：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
Package Control: Install Package并回车 - 等列表加载完后搜
Terminus（注意拼写，不是Terminal或SublimeTerminal） - 点它安装，完成即生效，不用重启
如果 Package Control 还没装，去官网复制安装脚本到 Sublime 控制台执行，别用第三方镜像或旧版脚本。
装完打不开终端？大概率是 shell 环境没对上
Terminus 启动时读的是 Sublime 启动那一刻的环境变量，不会自动加载 ~/.zshrc、~/.bashrc 或 nvm 初始化逻辑。所以你终端里能跑的 node、python3、pnpm，在 Terminus 里常报 command not found。
- 最简单解法：在
Preferences → Package Settings → Terminus → Settings里加"shell": "login"，让 shell 以登录模式启动，自动 source profile - Windows 用 Git Bash？不能只写
"bash"，得填完整路径："C:\Program Files\Git\bin\bash.exe"（反斜杠必须双写） - macOS 打不开？检查
/bin/zsh是否在系统PATH里；再看~/.zshrc有没有阻塞命令（比如卡在curl或sleep） - Linux 报
exec: "sh": executable file not found in $PATH？这不是插件问题，是你的系统环境变量坏了
快捷键和工作目录怎么配才不踩坑
默认没绑定快捷键，Ctrl+Shift+T 是新建标签页的热键，和终端冲突。建议改一个干净的，比如 Ctrl+`：
[
{ "keys": ["ctrl+`"], "command": "terminus_open", "args": { "cwd": "${file_path:${folder}}" } }
]
这个配置的关键点：
-
cwd参数确保终端打开在当前文件所在目录（未保存文件则 fallback 到项目根目录） - 别用
"working_dir": "$file_path"这种写法——那是老版Terminal插件的语法，Terminus不认 - 右键菜单里选 “Open Default Shell in Panel”，不是 “New Terminal”；后者开的是独立窗口，不是嵌入式面板
- 面板高度太小？直接拖顶部边框往上拉，Sublime 会记住尺寸
真正容易被忽略的是：Terminus 不支持开机自动打开终端面板，也不支持“右键文件夹 → 在此处打开终端”这种操作——那得靠 SideBarEnhancements 插件配合自定义命令才能实现。
