Sublime Text 4 中旧版 Terminal 插件已彻底失效,唯一可用终端插件是 Terminus;必须通过 Package Control 安装,需手动配置快捷键、shell 路径(如 "shell": "login")及 cwd 参数以确保环境变量和工作目录正确。

Sublime Text 4 装不了 Terminal 插件,别试了
旧版 Terminal 插件(作者 wbond)在 Sublime Text 4 上已彻底失效,不是配置问题,是底层 API sublime_api 被官方移除。强行安装会报 ImportError: No module named 'sublime_api',或菜单灰显、快捷键无响应。任何“兼容补丁”“手动改源码”方案都不可靠,且存在安全风险。
装 Terminus 是唯一可行路径
Terminus 是目前 Sublime Text 4 唯一持续维护、全平台支持、能真正嵌入面板运行交互式 shell 的终端插件。它不是 Terminal 的升级版,而是重写的新实现,支持多标签、SSH、会话复用和工作目录自动切换。
- 必须通过
Package Control安装:按Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Package Control: Install Package→ 回车 → 搜索Terminus→ 点击安装 - 手动下载 ZIP 或 git clone 到
Packages/目录会导致依赖缺失、JSON 解析失败或权限异常,不要这么做 - 安装后务必完全退出 Sublime Text 再重新启动,否则部分配置可能不加载
快捷键和 shell 路径必须手动配
Terminus 安装完默认没有快捷键,也不指定 shell,直接调用会黑屏或闪退。
- 打开
Preferences → Key Bindings,在右侧用户键位文件中添加类似配置:[{"keys": ["ctrl+alt+t"], "command": "terminus_open", "args": {"cwd": "${file_path:${folder}}"}}] -
cwd参数用${file_path:${folder}}可确保终端起始路径为当前文件所在目录;若只写${folder},没打开文件时会 fallback 到项目根目录 - 首次运行会弹窗让你选 shell 路径:Windows 填
cmd.exe或powershell.exe,macOS 填/bin/zsh,Linux 填/bin/bash;路径含空格或中文必须加双引号,例如"C:\Program Files\PowerShell\7\pwsh.exe" - PowerShell 用户注意执行策略:若
Get-ExecutionPolicy返回Restricted,需在管理员 PowerShell 中运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
想右键“Open Terminal Here”?得额外装插件
Terminus 本身不提供右键菜单项。如需该功能,必须配合 SideBarEnhancements 插件使用:
- 同样通过
Package Control安装SideBarEnhancements - 安装后,在侧边栏右键文件或文件夹,会出现
Open Terminal Here选项(实际调用的是Terminus的命令) - 该功能依赖
Terminus已正确配置 shell 路径,否则点击后无反应或报错shell not found
真正容易被忽略的是环境变量继承——Terminus 默认不加载你的 .zshrc 或 PATH,需要在插件设置里显式加 "shell": "login" 才能跑通 git、python 或虚拟环境命令。

















