sublime text 4 中旧版 terminal 插件因底层 api sublime_api 被彻底移除而无法运行，报错 importerror 或菜单灰显均属正常；唯一可行方案是通过 package control 安装 terminus，并手动配置 "shell": "login" 和 "cwd": "${file_path:${folder}}" 以确保环境变量与工作目录正确。
Sublime Text 4 装 Terminal 插件根本跑不起来
不是你配置错，是插件底层 API 已被 Sublime Text 4 彻底移除。ImportError: No module named 'sublime_api' 这类报错说明它调用的接口不存在了。强行安装会导致菜单灰显、快捷键失灵、右键无响应——别试兼容补丁，直接放弃。
Terminus 必须走 Package Control 安装
手动把 ZIP 解压到 Packages/ 目录，或用 git clone，99% 会失败：依赖缺失、JSON 解析错误、权限异常全可能触发。唯一可靠路径只有：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
Package Control: Install Package并回车 - 等列表加载完后搜
Terminus（注意拼写，不是Terminal或SublimeTerminal） - 点它安装，完成即生效，不用重启
环境变量不对？加 "shell": "login"
你在系统终端里能跑的 node、pnpm、python3，在 Terminus 里报 command not found，大概率是 shell 启动没读 ~/.zshrc 或 ~/.bashrc。解决方法很简单：
- 进
Preferences → Package Settings → Terminus → Settings - 在用户设置里加一行：
"shell": "login" - Windows 用 Git Bash？不能只写
"bash"，得填完整路径："C:\Program Files\Git\bin\bash.exe"（反斜杠必须双写） - macOS 报错找不到
/bin/zsh？检查系统 PATH 是否包含它，再看~/.zshrc里有没有阻塞语句（比如卡在curl或sleep）
快捷键和工作目录容易配错
默认没绑定任何快捷键，Ctrl+Shift+T 是新建标签页的热键，和终端冲突。建议用干净组合键，比如 Ctrl+`：
- 进
Preferences → Key Bindings，右侧用户配置里加：{"keys": ["ctrl+`"], "command": "terminus_open"} - 如果想让终端默认打开当前文件所在目录，加
"cwd": "${file_path:${folder}}"到args里 - 没打开文件时
${file_path}为空，${folder}会 fallback 到项目根目录；但若没打开项目，就落到用户主目录——这点常被忽略
最麻烦的其实是 cwd 和 shell 的组合影响：比如 "shell": "login" 在 macOS 上会自动 cd 到 home，覆盖掉你设的 cwd，这时得用 "shell": "zsh -l -i -c 'cd ${file_path:${folder}} && exec zsh -l -i' 这种绕过方式，但代价是启动慢、历史记录不稳定。
