Terminus是Sublime Text 4唯一兼容且功能完整的终端插件，必须通过Package Control标准流程安装，配置需指定shell路径、cwd参数及"shell": "login"以确保环境正确加载。
Terminus 是唯一可用的终端插件，别试 Terminal
Sublime Text 4 完全不兼容旧版 Terminal 插件——它依赖的 sublime_api 模块已被移除，安装后必然报 ImportError: No module named 'sublime_api'，菜单灰显、快捷键失灵是常态。手动下载 ZIP 或 clone 仓库也无效，会因依赖缺失或 JSON 解析失败直接挂掉。目前唯一稳定、持续更新、支持方向键/Ctrl+C/多标签/真彩色的方案只有 Terminus，且必须通过 Package Control 安装。
安装 Terminus 必须走 Package Control 四步法
跳过任何“手动放文件”“用旧脚本”“改权限”的操作，只认标准流程：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）呼出命令面板 - 输入
Package Control: Install Package并回车，等列表加载完成（通常需 10–30 秒） - 搜
Terminus（注意拼写，不是Terminal、SublimeTerminal或带fork的变体），点击安装 - 装完不需重启，但建议关闭所有 Sublime 窗口再重开——否则缓存可能让
terminus_open命令完全无响应
如果命令面板里压根没有 Package Control: Install Package，说明 Package Control 没装好：去官网复制带 hashlib.sha256 校验的新版安装脚本，粘贴到控制台（Ctrl+`）执行，别用镜像或旧版。
终端一打开就空白或闪退？先查 shell 路径和环境
Terminus 不自带 shell，它只是调用你系统已有的 bash、zsh、pwsh 或 cmd.exe。报 Unable to find shell 或卡死，90% 是 shell 启动失败，不是插件问题：
- Windows 用户用 Git Bash？必须进
Preferences → Package Settings → Terminus → Settings手动加shell_configs，填完整路径："C:\Program Files\Git\bin\bash.exe"（反斜杠要双写） - macOS 用户用
zsh却打不开？先运行echo $PATH | grep zsh确认/bin/zsh在路径里；再检查~/.zshrc是否有阻塞语句（比如超时的curl） - Linux 下报
exec: "sh": executable file not found in $PATH？直接echo $PATH，大概率是环境变量被清空或覆盖 - 验证方法：在快捷键配置中临时写
{"cmd": ["/bin/bash", "--norc", "--noprofile"]}，能跑通，说明问题出在你的 shell 配置文件里
快捷键唤出终端，怎么默认在当前文件目录？
直接绑 {"command": "terminus_open"}，终端大概率开在 Sublime 启动时的工作目录（通常是家目录），而不是你正在编辑的文件位置。正确做法是在快捷键配置中传 cwd 参数：
[{"keys": ["ctrl+alt+t"], "command": "terminus_open", "args": {"cwd": "${file_path:${folder}}"}}]
这个表达式意思是：有文件打开时取其所在目录（${file_path}），没文件时退回到当前项目根目录（${folder}）。另外，强烈建议在 Terminus 设置中加 "shell": "login"，让 shell 以登录模式启动，自动 source 你的 ~/.zshrc 或 ~/.bashrc，否则 node、pnpm、python3 全部 command not found。
最易被忽略的是：shell 配置文件里的阻塞逻辑（比如未设 timeout 的 curl）、路径中含空格未加引号、以及 Windows 上 Git Bash 路径写错斜杠——这些不会报错，只会让终端静默失败。
