Terminus插件不接管Sublime Text的Ctrl+B构建逻辑，需手动通过terminus_open命令传入shell_cmd（如"npm run build"）在终端中执行；其默认不继承shell环境变量，需配置登录shell或用绝对路径；面板行为需显式设置auto_hide_panel、focus_on_success等参数优化体验。
Terminus插件装好后，build命令不执行？先确认构建系统是否绑定到Terminus
Sublime Text默认的build快捷键（Ctrl+B / Cmd+B）触发的是内置构建系统，和Terminus无关。Terminus本身不接管build逻辑，它只是个终端模拟器——想让它运行构建命令，得手动把命令发给它。
常见错误现象：Ctrl+B没反应、终端弹出但没执行npm run dev之类、报错command not found。
- 确保已安装
Terminus且重启过Sublime - 检查当前文件是否关联了有效的构建系统（右下角状态栏应显示如
JavaScript或NodeJS；若显示None，按Ctrl+Shift+P→ 输入Set Build System选择对应项） - 构建系统必须是“shell型”而非“program型”，即
cmd字段是字符串数组（如["npm", "run", "dev"]），不是单个可执行路径
如何让Terminus自动运行当前构建系统的命令？用terminus_open命令加shell_cmd参数
Terminus提供terminus_open命令，支持直接传入shell_cmd，绕过构建系统配置。这是最可控的方式。
操作步骤：
- 打开命令面板（
Ctrl+Shift+P），输入Terminus: Open Default Shell in Panel，回车——这只是打开空终端，不执行构建 - 真正要运行构建命令，需调用
terminus_open并指定shell_cmd，例如：{ "caption": "Build in Terminus", "command": "terminus_open", "args": { "shell_cmd": "npm run build" } } - 把这个定义保存为
Build in Terminus.sublime-commands（放在Packages/User/目录），就能在命令面板里直接调用 - 如需动态读取当前构建系统的
cmd，得写Python插件——Terminus原生不支持自动解析.sublime-build文件
为什么npm或python在Terminus里找不到？PATH环境变量没继承
Terminus默认启动的是非登录shell，不会加载~/.bashrc或~/.zshrc，导致npm、poetry等依赖shell初始化的工具不可用。
解决方法分平台：
- macOS / Linux：在
Terminus设置中修改shell_configs，把env里的SHELL指向/bin/zsh --login或/bin/bash --login - Windows：确保
shell_configs中cmd值为["powershell.exe", "-ExecutionPolicy", "Bypass", "-NoExit", "-Command"]，否则PowerShell策略会拦截npm - 更稳妥的做法：不用改shell，直接在
shell_cmd里写绝对路径，比如/Users/you/.nvm/versions/node/v18.17.0/bin/npm run build
想一键构建+监听输出？别依赖Terminus自动刷新，用auto_hide_panel和focus_on_success控制体验
Terminus面板默认不会自动隐藏或聚焦，构建命令跑完后还得手动切回去看结果，容易漏掉错误。
优化建议：
- 在
terminus_open调用中加入"auto_hide_panel": false（保持面板常开）和"focus_on_success": true（命令结束后自动聚焦到面板） - 如果构建命令本身带watch（如
webpack --watch），记得加"keep_open": true，否则Terminus会在进程退出后关闭面板 - 注意：Terminus不解析构建输出中的ANSI颜色码，默认是黑白文本；如需彩色，得在
settings里开启enable_color
复杂点在于，不同项目用的包管理器（npm/yarn/pnpm）、构建工具（vite/next/django）命令格式差异大，没法靠一个通用配置覆盖所有场景。最稳的方式还是为每个项目单独配一条terminus_open命令。
