Terminus是Sublime Text唯一支持内嵌、交互与会话复用的终端插件;需手动配置shell路径、cwd参数(如"${file_path:${folder}}")、环境变量(如补全PATH)及启动模式(如"shell":"login"),否则易出现command not found、闪退、方向键失灵等问题。

Terminus 是 Sublime Text 唯一真正支持内嵌、交互、会话复用的终端插件;装完不配置,90% 的人会遇到 command not found、终端闪退、方向键失灵、路径不对等问题——这不是插件坏了,而是它默认不加载你的 shell 配置文件(~/.zshrc、~/.bash_profile),也不继承系统完整的 PATH。
为什么 python 或 npm 在 Terminus 里报 “command not found”
Sublime 启动时读取的是桌面环境的初始环境变量,不是你日常终端里的环境。Terminus 默认以 non-login、non-interactive 模式启动 shell,跳过 ~/.zshrc 等配置加载,导致 PATH 缺失、别名失效、nvm/pvm/pyenv 不生效。
- macOS 用户最常踩坑:从 Dock 或 Finder 启动 Sublime,
PATH里根本没有/opt/homebrew/bin或/usr/local/bin - 解决方案不是改插件,而是改启动方式:终端中执行
subl .启动 Sublime,它才能继承当前 shell 的完整环境 - 如果必须从图标启动,就在 Terminus 设置里显式补全
env:"env": { "PATH": "/opt/homebrew/bin:/usr/local/bin:${PATH}" } - Windows 上 Git Bash 报错?不能只写
bash,必须填绝对路径:"C:\Program Files\Git\bin\bash.exe"(反斜杠要双写)
terminus_open 命令参数怎么配才对
直接调 Terminus: Open Default Shell in Panel 往往不够用。你需要根据场景手动指定 shell 类型、参数和工作目录,否则可能进错目录、卡在登录脚本、或无法中断命令。
- 想强制走 login shell(加载
~/.zshrc):{"shell": "login"} - 想跳过所有配置快速启动干净 shell(排查用):
{"cmd": ["/bin/zsh", "--norc", "--noprofile"]} - Windows 下用 PowerShell 并自动切到当前文件目录:
{"cmd": ["powershell.exe", "-NoExit", "-Command", "Set-Location '%CWD%'"]} - 工作目录想默认落到项目根而非当前文件?设置
default_working_dir为$project_path,不是$file_path
快捷键冲突和面板行为怎么调才顺手
默认 Ctrl+Shift+T 和“新建标签页”冲突,且 Ctrl+` 在部分键盘上难按;面板默认高度太小、关闭后不记忆尺寸、右键菜单没“在此打开”——这些都不是 bug,是设计如此,但可调。
- 改快捷键:Preferences → Key Bindings → 右侧加一条:
{"keys": ["ctrl+`"], "command": "terminus_open"} - 面板高度:鼠标悬停在面板上边缘,光标变双箭头后拖拽即可;Sublime 会记住这个高度
- 右键添加“在此打开终端”:需配合
SideBarEnhancements插件,在其自定义命令中调用terminus_open并传参"cwd": "$file_path" - 注意:
Tools → Terminus → Open Default Shell in Panel才是嵌入式面板;别点 “New Terminal”,那是开外部窗口
最易被忽略的一点:Terminus 不会自动 reload shell 配置。改了 ~/.zshrc 后,已打开的 Terminus 标签页不会生效,必须关掉重开,或者手动执行 source ~/.zshrc ——但它只影响当前会话,新标签页仍得重新 source。

















