必须安装terminus插件,旧版terminal插件因api移除已彻底失效;terminus是sublime text 4唯一支持方向键、ctrl+c中断、多标签及自动同步工作目录的嵌入式终端方案。

要在Sublime Text 4中真正用上嵌入式终端,必须安装Terminus插件——旧版Terminal插件已因API移除彻底失效,装了也打不开,还会拖慢启动速度甚至引发崩溃;而Terminus是目前唯一能稳定支持方向键、Ctrl+C中断、多标签和工作目录自动同步的终端集成方案。
确认前提条件
打开Sublime Text,按 Ctrl+`(反引号)调出控制台,输入 import sublime_plugin 并回车。如果无报错,说明Sublime运行环境正常;若提示 ImportError: No module named 'sublime_plugin',说明Package Control未正确加载或被杀毒软件拦截,需先重装Package Control。
确保系统已安装可用shell:Windows用户验证能否在开始菜单直接打开PowerShell或CMD;macOS用户在Spotlight搜“终端”并运行 zsh --version;Linux用户执行 which bash。Terminus不自带shell,它只调用你系统里已有的那个。
通过Package Control安装Terminus
这是唯一推荐路径,手动克隆仓库易出权限或路径错误,且无法自动更新。
第一步:按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)呼出命令面板。
第二步:输入 Package Control: Install Package,回车等待插件列表加载完成——这个过程可能需10~30秒,别手快重复点击。
第三步:在搜索框中输入 Terminus,注意只认这个名字,不是“Terminal”“SublimeTerminal”或任何带“fork”的变体;作者必须是 wbond。点击后状态栏会显示“Installing Terminus…”。
安装完成后不要重启,但建议关闭所有Sublime窗口再重新打开一次——否则面板缓存可能冲突,导致后续 terminus_open 命令完全无响应。
验证是否安装成功
方法一:再次按 Ctrl+Shift+P,输入 Terminus: Open Default Shell in Panel。如果命令出现且回车后底部弹出黑底窗口,说明安装成功。
方法二:进入菜单栏 Preferences → Package Settings → Terminus。若能看到子菜单项(如Settings、Key Bindings),即表示插件已加载;若该菜单为空或根本不存在,说明下载中断,需删除 Packages/Terminus/ 文件夹后重试。
【注意】 如果控制台(Ctrl+`)报错 ImportError: No module named terminus,这不是配置问题,是安装包损坏,删掉对应文件夹即可。
首次启动时的关键选择
第一次执行 Terminus: Open Default Shell in Panel 时,会弹出输入框要求填写 shell 路径:
Windows用户填 cmd.exe 或 powershell.exe(推荐后者),路径不用加引号,也不用写全盘符;若填错,终端会黑屏或闪退。
macOS用户填 /bin/zsh 或 /bin/bash,必须带绝对路径;若系统已升级到zsh但老项目依赖bash,这里选错会导致 source ~/.bashrc 失效。
Linux用户填 sh 或 bash,若报 exec: "sh": executable file not found in $PATH,说明系统环境异常,不是插件问题,需先修复PATH变量。











