terminus插件安装失败多因package control未正常联网,需重装官方脚本并重启;配置工作目录须用${file_path}变量,启用login shell解决环境变量问题,键位配置须严格遵循json语法且command名正确。

Terminus 插件装不上?先确认 Package Control 是活的
装不上 Terminus,90% 不是插件问题,而是 Package Control 没真正就位。它不是“菜单里有”就算安装成功,得看它能不能联网拉列表。
- 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(Mac),输入Package Control: Install Package—— 如果报错“No command”,说明没装好或损坏了 - 重装别手抖复制旧脚本:Sublime Text 4 推荐用官方最新安装码(含 SHA256 校验),控制台粘贴后必须重启才生效
- 装完别急着搜
Terminus,先等几秒——插件列表是异步加载的,立刻搜会返回空,容易误判失败 - 别搜
Terminal或SublimeTerminal,名字就是Terminus,大小写敏感,拼错就装错包
终端打开却不在当前文件目录?${file_path} 必须手动配
默认打开终端,工作目录是用户主目录(C:UsersXXX 或 ~/),不是你正在编辑的文件夹。这不是 bug,是设计如此;不配就永远 cd 不进去。
- 进
Preferences → Package Settings → Terminus → Settings,在右侧用户设置里加这段:
{
"default_config": {
"linux": { "cmd": ["bash"], "working_dir": "${file_path}" },
"osx": { "cmd": ["zsh"], "working_dir": "${file_path}" },
"windows": { "cmd": ["powershell.exe"], "working_dir": "${file_path}" }
}
}
-
${file_path}是 Sublime 的变量,表示当前文件所在目录;没开文件时 fallback 到项目根目录;别写成${file}(那是带后缀的全路径)或硬编码路径 - Windows 用户若用 Git Bash,
cmd得写绝对路径:"C:\Program Files\Git\bin\bash.exe",斜杠要双写,单引号不行 - macOS / Linux 用户如果终端一闪退,大概率是
~/.zshrc或~/.bashrc里有exit或异常echo,得注释掉再试
快捷键一按没反应?检查命令名和 JSON 语法
配了 ctrl+` 却没弹出终端,不是快捷键被占用了,而是配置本身无效——JSON 多一个逗号、少一个引号,整条规则就静默失效。
- 进
Preferences → Key Bindings,只在右侧「用户键位」里加,左侧默认设置别碰 - 正确写法(注意中括号、逗号、引号):
[{ "keys": ["ctrl+`"], "command": "terminus_open" }]
-
command名必须是terminus_open,不是open_terminus或terminal_open;大小写错一个字母就不认 - 想让终端自动进项目根目录(而非当前文件夹),把
"working_dir": "${file_path}"换成"${folder}" - Mac 用户注意:系统级快捷键如
Cmd+Space(Spotlight)可能劫持Cmd+`,可换用Cmd+Shift+T
Python/node 命令报 “not found”?环境变量没继承过来
终端面板里敲 python --version 或 node -v 报错,不代表你没装,而是 Terminus 启动时没加载 shell 的 profile 文件(比如 ~/.zshrc),PATH 没生效。
- 最稳解法:在 Terminus 设置里启用 login shell 模式,Linux/macOS 加
"shell_args": ["-l"],Windows PowerShell 加"shell_args": ["-Login"] - 或者显式补全 PATH,在
env字段里写死(适合 Windows):
"env": { "PATH": "C:\Python39;C:\Users\XXX\AppData\Roaming\npm;%PATH%" }
- 别指望 Build System 替代终端:用
{"cmd": ["python", "$file"]}跑一次就关,没法交互、不能 pip install、看不到实时日志 - 如果你常用 tmux/screen,注意 Terminus 调起的是外层 shell,但实际渲染走的是 tmux session —— 需单独配 tmux 的
set -g default-shell和set -g default-path
字体显示方块、中文乱码、PowerShell 里 Ctrl+V 粘贴失效……这些问题背后,几乎都卡在 shell 初始化链路断了一环。配终端不是填几个字段就完事,得顺着它启动时真实走的那条路径去对。











