Sublime如何集成终端 (Terminal)？ (Terminus插件安装与使用)

Terminus 插件可为 sublime Text 无缝集成系统终端，推荐通过 Package Control 安装；安装后用快捷键（Ctrl+Shift+T/Cmd+Shift+T）调出，支持多标签、自定义 Shell、自动切换工作目录及项目根目录识别。

sublime text 本身不内置终端，但通过 Terminus 插件可以无缝集成系统终端（支持 windows、macOS、linux），且支持多标签页、自定义 Shell、快捷键唤出等实用功能。

如何安装 Terminus 插件

推荐使用 Package Control 安装，避免手动下载出错或版本不兼容：

• 按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板
• 输入 Package Control: Install Package 并回车
• 搜索 Terminus，选择并安装（注意名称是 Terminus，不是 Terminal 或 SublimeTerminal）
• 安装完成后无需重启 Sublime，插件即生效

如果 Package Control 未安装，先去官网获取安装脚本，再执行；不要从 gitHub 直接 clone 到 Packages/ 目录——容易漏依赖或权限异常。

如何调用和配置终端面板

安装后终端不会自动弹出，需手动触发。常用方式有三种：

• 快捷键：Ctrl+Shift+T（Windows/Linux）或 Cmd+Shift+T（macos）——默认绑定，可修改
• 右键菜单：在编辑区或侧边栏右键 → Terminus: Open default Shell in Panel
• 命令面板：Ctrl+Shift+P → 输入 Terminus: Open Default Shell in Panel

首次运行时，Terminus 会读取系统环境变量，自动识别默认 Shell（如 Windows 的 cmd.exe 或 powershell.exe，macOS/Linux 的 zsh 或 bash）。若想改用其他 Shell（比如 Windows 上用 git-bash），需在 Preferences → Package Settings → Terminus → Settings 中修改 shell_configs 和 default_config。

常见问题与避坑点

多数失败不是插件问题，而是路径、权限或 Shell 配置偏差导致：

• Terminus 在 Windows 上调用 git-bash 时，必须填写完整路径，例如："C:\Program Files\Git\bin\bash.exe"，不能只写 bash
• macOS Catalina 及以后默认 Shell 是 zsh，但某些旧项目依赖 bash，需在 shell_configs 中显式添加 bash 配置并设为默认
• 终端面板默认固定在底部，若拖动后消失，可通过 View → Show Panel → Terminus 重新唤出
• 执行 python 或 node 命令报“command not found”，大概率是 Sublime 启动时没加载用户 shell profile（如 ~/.zshrc），需在 Terminus 设置中启用 env 选项或改用 login shell 模式

终端与当前项目/文件联动技巧

Terminus 支持基于当前视图自动切换工作目录，提升开发流效率：

• 在任意文件中右键 → Terminus: Open Default Shell in Panel (with current file's Directory)，终端会直接 cd 进该文件所在目录
• 在侧边栏文件夹上右键 → 同样选项，会进入该文件夹路径
• 如需每次打开都自动定位到当前项目根目录，可在 Terminus 设置中开启 auto_cd_project_root（需配合 project_root_patterns 如 ["package.json", ".git", "pyproject.toml"]）

注意：auto_cd_project_root 不会覆盖你手动 cd 的路径，仅在新终端启动时生效；且它依赖文件系统扫描，大型项目可能轻微延迟。

{     "shell_configs": [         {             "name": "Git Bash",             "cmd": ["C:\Program Files\Git\bin\bash.exe", "-l", "-i"],             "env": {"CHERE_INVOKING": "1"}         }     ],     "default_config": "Git Bash",     "auto_cd_project_root": true,     "project_root_patterns": ["package.json", ".git", "manage.py"] }

真正麻烦的不是装不上，而是装完发现终端不认 npm、路径不对、或者新开标签页又回到 home 目录——这些都得靠配置里的 env、-l 参数和 project_root_patterns 组合解决，而不是反复重装插件。