Terminus 是 Sublime Text 中唯一能真正嵌入完整终端的插件。需先确保 Package Control 正常，再通过命令面板安装；配置快捷键 ctrl+` 并指定 shell 和 cwd；运行脚本须用 terminus_exec 构建系统；乱码问题需在 Terminus 设置中启用登录 shell 并配置编码。
Terminus 是目前 Sublime Text 中唯一能真正嵌入完整终端（bash/zsh/PowerShell/cmd）的插件，不装它，就只能调外部窗口——体验断层、无法复用面板、不能分屏查日志。
怎么装 Terminus？别跳过 Package Control 检查
很多报错其实卡在第一步：Package Control 没装好或失效。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package，回车 - 如果提示“command not found”，说明 Package Control 未安装——去 packagecontrol.io 复制对应版本的 Python 安装代码，粘贴进 Sublime 的
View → Show Console运行 - 再次打开命令面板，搜
Terminus，点击安装；安装后**不用重启**，但首次使用建议关闭再重开一次 Sublime
快捷键一按就出终端：ctrl+` 配置要点
默认没绑定快捷键，必须手动加。很多人配了却无效，问题常出在 JSON 格式或路径变量上。
- 进入
Preferences → Key Bindings，在右侧用户配置区添加：
[
{
"keys": ["ctrl+`"],
"command": "terminus_open",
"args": {
"cmd": ["bash"],
"cwd": "${file_path:${folder}}",
"title": "Terminal"
}
}
]-
cmd值要匹配你系统真实可用的 shell：bash（macOS/Linux）、cmd.exe或powershell.exe（Windows） -
cwd用${file_path:${folder}}而不是硬写路径，确保打开时自动定位到当前文件目录或项目根目录 - 如果按了没反应，检查是否和其他插件快捷键冲突（比如某些输入法会劫持
ctrl+`）
运行当前 Python 文件？别用普通 Build System
直接按 Ctrl+B 默认走 Sublime 自带构建系统，和 Terminus 无关。想在 Terminus 面板里跑脚本，必须用它的专用 target。
- 新建构建系统：
Tools → Build System → New Build System… - 填入（以 Python 为例）：
{
"target": "terminus_exec",
"cancel": "terminus_cancel_build",
"shell_cmd": "python \"$file\"",
"working_dir": "$file_path",
"file_regex": "^[ ]*File \"(.*)\", line ([0-9]*)"
}- 保存为
Python - Terminus.sublime-build，然后在 Python 文件中选这个构建系统，再按Ctrl+B - 关键点：
"target": "terminus_exec"这一行不能少，否则命令会在新弹窗执行，不会进底部面板 - Windows 用户注意双引号转义：
"python \"$file\""中的\"是必须的，否则路径含空格时报错
终端打开了但乱码/打不出中文/光标错位？看 shell 配置
Terminus 默认调用系统 shell，但不继承你的 shell 配置（如 ~/.zshrc 或 PSModulePath），环境变量和编码可能缺失。
- 进
Preferences → Package Settings → Terminus → Settings - 追加 shell 配置（以 macOS 使用 zsh 为例）：
{
"shell_configs": [
{
"name": "zsh",
"cmd": ["zsh", "-i", "-l"],
"env": {"LANG": "zh_CN.UTF-8"},
"enable": true
}
]
}-
-i -l表示交互式 + 登录 shell，这样才能加载你的 profile - Windows 上若 PowerShell 中文乱码，需确认系统区域设置为“Beta: 使用 Unicode UTF-8 提供全球语言支持”（设置 → 时间和语言 → 区域 → 管理 → 更改系统区域设置）
- 字体渲染异常？Terminus 设置里可单独指定
"font_face": "Fira Code"等等宽字体，避免 emoji 或连字干扰
真正的坑不在安装，而在「以为打开了终端，其实只是调了个 cmd 窗口」——只有 terminus_open 命令 + 正确 cwd 变量 + 匹配的 shell 名称，才能让终端和编辑器形成工作流闭环。配完别急着写代码，先在面板里敲个 ls 和 git status 看路径对不对、中文显不显示，再推进下一步。
