sublime text 4 中旧版 terminal 插件因 api 移除已失效,应改用持续维护的 terminus 插件;需手动配置快捷键、正确设置 shell 路径及执行策略,避免使用不安全的兼容补丁。

Terminal 插件在 Sublime Text 4 上根本不能用
Sublime Text 4 官方已移除对 Package Control 中旧版 Terminal 插件(作者 wbond)的兼容支持,强行安装会报 ImportError: No module named 'sublime_api' 或插件完全不响应。这不是你配置错了,是插件底层 API 已失效。
替代方案:改用 Terminus(推荐)
Terminus 是目前 Sublime Text 4 唯一稳定、持续维护的终端集成插件,支持 Windows/macOS/Linux,能嵌入面板、绑定快捷键、保存会话。它不是“Terminal 插件的升级版”,而是重写的替代品。
- 通过
Package Control: Install Package搜索并安装Terminus - 安装后默认无快捷键,需手动绑定:打开
Preferences → Key Bindings,添加类似配置:[{"keys": ["ctrl+alt+t"], "command": "terminus_open", "args": {"cwd": "${file_path:${folder}}"}}] - 首次运行会提示选择 shell 路径(如 Windows 用
cmd.exe或powershell.exe,macOS 用/bin/zsh),填错会导致黑屏或闪退 - 不支持直接调用系统右键菜单“Open Terminal Here”——这是旧
Terminal插件的功能,Terminus需靠快捷键或命令面板(Ctrl+Shift+P→Terminus: Open Default Shell in Panel)触发
Windows 下 cmd/powershell 启动失败的常见原因
不是路径写错就是权限/策略拦住了,尤其公司电脑或教育版系统。
- 检查路径是否带空格或中文:比如
C:Program FilesPowerShellpwsh.exe必须用双引号包裹,在Terminus设置里写成"C:\Program Files\PowerShell\7\pwsh.exe" - PowerShell 执行策略限制:管理员身份运行
powershell.exe,执行Get-ExecutionPolicy;若返回Restricted,临时放开用Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 杀毒软件或组策略可能拦截子进程创建,可先试
cmd.exe确认基础功能是否正常
为什么别折腾旧 Terminal 插件的“兼容补丁”
网上流传的修改 terminal.py、替换 sublime_api 引用等操作,本质是在绕过 Sublime Text 的沙箱机制,极易导致:
- 插件加载失败后拖慢整个启动速度
- 偶尔触发
sublime_text.exe崩溃(无错误日志,直接退出) - 升级 Sublime Text 后全部失效,且无法回滚到旧版(ST4 不提供官方降级通道)
- 和
SideBarEnhancements、GitSavvy等常用插件存在 hook 冲突,表现为右键菜单消失或命令无响应
真正省时间的做法,是接受 Terminus 的行为逻辑:它不模拟系统右键,也不自动 cd 到当前文件夹(除非你配好 cwd 参数),这些细节恰恰是它稳定的原因。










