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 看路径对不对、中文显不显示,再推进下一步。