Terminus 是 Sublime Text 4 推荐的终端插件，需通过 Package Control 安装；Windows/macOS/Linux 用户须正确配置 shell_configs 路径，设置 default_working_dir 为 $project_path 或 $file_path 实现自动定位，并重映射 Ctrl+Shift+T 避免冲突。
Sublime Text 本身不内置终端，但可以通过 Terminal 插件（即 Terminus 或更早的 Terminal）实现在编辑器内调用系统命令行。目前推荐使用 Terminus，原生支持 Windows/macOS/Linux，兼容 Sublime Text 4，且维护活跃。
怎么安装 Terminus 插件（替代旧 Terminal）
旧版 Terminal 插件已停止更新，与 ST4 兼容性差，容易报错 ImportError: No module named 'sublime_plugin' 或无法启动。应改用 Terminus：
- 打开 Sublime Text →
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）调出命令面板 - 输入
Package Control: Install Package并回车 - 等待列表加载完成，输入
Terminus，选中并回车安装 - 安装完毕后，可通过
Ctrl+Shift+T（默认快捷键）快速打开内嵌终端
为什么 Terminus 启动后是空白或报错「shell not found」
Terminus 默认尝试调用 bash（macOS/Linux）或 cmd.exe（Windows），但路径配置不对就会失败。常见表现：窗口一闪而退、显示 shell not found、或黑屏无响应。
- Windows 用户需确认是否设置了正确的 shell 路径：打开
Preferences → Package Settings → Terminus → Settings，在右侧用户设置中添加：
{
"shell_configs": [
{
"name": "Command Prompt",
"cmd": ["cmd.exe"],
"env": {}
},
{
"name": "PowerShell",
"cmd": ["powershell.exe", "-NoExit", "-Command"],
"env": {}
}
]
}
- macOS 用户若使用
zsh（默认）但提示找不到 shell，检查which zsh输出，并在设置中显式指定完整路径，例如"/bin/zsh" - Linux 用户注意：部分发行版（如 Ubuntu 22.04+）默认用
/usr/bin/bash，而非/bin/bash，路径写错会导致启动失败
如何让 Terminus 在当前项目根目录自动启动
默认 Terminus 打开的是用户 home 目录，不是当前打开的文件所在文件夹。要让它“跟着项目走”，需启用工作目录自动识别：
- 确保当前 Sublime 窗口已通过
File → Open Folder...打开了一个项目根目录（而不是只打开单个文件） - 在
Terminus设置中添加："default_working_dir": "$project_path" - 如果项目未关联文件夹（比如只打开了单个
.py文件），$project_path为空，此时可改用："default_working_dir": "$file_path"—— 这会让终端定位到当前文件所在目录
快捷键冲突和常用操作建议
Ctrl+Shift+T 在 Sublime 中默认是「新建标签页」，与 Terminus 的「打开终端」冲突。必须手动重映射：
- 打开
Preferences → Key Bindings - 在右侧用户键绑定中添加（覆盖默认行为）：
[
{
"keys": ["ctrl+shift+t"],
"command": "terminus_open",
"args": {
"cwd": "$project_path"
}
}
]
- 其他实用操作：
Ctrl+Shift+P → Terminus: Open Default Shell in Panel可将终端嵌入底部面板（非新窗口），适合边写代码边调试 - 终端中执行命令后，想快速跳转到报错文件行？Terminus 支持点击含
file.py:123格式的输出，自动打开对应文件并跳转——前提是路径为相对当前工作目录的合法路径
真正卡住人的往往不是装不上，而是 shell 路径写错、工作目录没设对、或者快捷键被覆盖却没察觉。装完插件先别急着敲命令，打开设置看一眼 shell_configs 和 default_working_dir 是不是按你系统的实际路径写的。
