terminus是sublime text唯一稳定支持交互式终端会话的嵌入式插件，需通过package control安装，配置cwd参数确保工作目录正确，启用login shell以继承环境变量，并避免使用已失效的terminal类插件。
Sublime Text 本身没有内置终端，所谓“一键集成”，实际是靠 Terminus 插件实现的嵌入式终端面板——它不是快捷方式，而是需要正确配置环境、路径和启动行为，否则点一下就报错或空白。
Terminus 是唯一能用的嵌入式终端插件
别试 Terminal 插件：它在 Sublime Text 4 上已彻底失效，会触发 ImportError: No module named 'sublime_api'，菜单灰显、快捷键无响应。官方 API 移除后，所有旧版 Terminal 类插件都不可靠。只有 Terminus 持续维护，且支持 Win/macOS/Linux 三平台。
- 必须通过
Package Control安装，手动复制 ZIP 或 git clone 到Packages/目录会导致依赖缺失、JSON 解析失败 - 安装路径唯一正确操作：
Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜索Terminus→ 点击安装 - 装完不重启也能用，但首次启用前建议确认
Preferences → Package Settings → Terminus → Settings是否可打开
快捷键绑定必须带 cwd 参数
默认没快捷键，光写 {"keys": ["ctrl+`"], "command": "terminus_open"} 会打开一个 shell，但工作目录常是用户主目录，不是你当前编辑的文件所在路径——导致 python main.py 找不到模块，npm run dev 报 package.json not found。
- 正确写法要传
cwd参数：{"keys": ["ctrl+`"], "command": "terminus_open", "args": {"cwd": "${file_path:${folder}}"} } -
${file_path}表示当前文件所在目录；${folder}是项目根目录（当文件未保存时 fallback） - 别用
Ctrl+T：它默认是新建标签页，冲突；Ctrl+Shift+T是重开关闭的标签，也别占
macOS/Linux 下 shell 启动必须加 "shell": "login"
你在 iTerm 里能跑的 node、pnpm、pyenv，在 Terminus 里常报 command not found——不是插件问题，是 Sublime 启动时没加载你的 shell profile。
- 进
Preferences → Package Settings → Terminus → Settings，加这一行："shell": "login" - 这会让 shell 以登录模式启动，自动执行
~/.zshrc或~/.bash_profile - Windows 用户若用 Git Bash，不能只写
"bash"，得填完整路径："C:\Program Files\Git\bin\bash.exe"（反斜杠必须双写） - 检查
/bin/zsh是否在系统 PATH 中：echo $PATH对比终端和 Terminus 输出，不一致就说明环境变量没继承
终端面板位置和多会话管理
Terminus 默认在底部面板打开，但容易被构建输出、侧边栏遮挡；而且新开终端不会自动复用已有会话，频繁 Ctrl+` 会堆满标签页。
- 右键编辑区 →
Terminus → Open Default Shell in Panel可强制嵌入底部，避免弹窗抢占焦点 - 想新开独立终端标签页？用命令面板：
Ctrl+Shift+P→ 输入Terminus: Open Terminal in Project Folder - 关闭单个标签页：鼠标悬停在标签上点 ×；关闭全部：
Ctrl+Shift+P→Terminus: Close Terminated View - 终端输出太多卡顿？在 Settings 里加
"scrollback": 1000限制历史行数，避免内存暴涨
真正卡住人的从来不是装不装得上，而是 shell 没走 login 模式、cwd 没动态绑定、Package Control 装错版本——这三个点漏掉任何一个，“一键”就变成“一串报错”。
