Sublime Terminal 插件无反应主因是ST4默认禁用exec命令，需在用户设置中启用"shell": true并清除ignored_packages中的"Terminal"；Windows需配shell_cmd用PowerShell，macOS/Linux需排查shell初始化文件退出问题。
Sublime Terminal 插件装完没反应？检查是否禁用了内置终端支持
Sublime Text 4 默认禁用 exec 命令调用系统 shell，而 Terminal 插件底层依赖它。装完插件却点不弹终端，大概率是这个原因。
- 打开
Preferences → Settings，在右侧用户设置里加一行："shell": true - 确保没有全局禁用：
"ignored_packages": ["Terminal"]这类配置要删掉 - Windows 用户注意：
shell设为true后，默认调用cmd.exe；想用 PowerShell，得额外配"shell_cmd": ["powershell.exe", "-NoExit", "-Command"] - macOS / Linux 下如果终端一闪而退，大概率是 shell 初始化文件（如
~/.zshrc）里有exit或异常echo，导致子进程提前终止
终端路径不对？working_dir 和 shell_cmd 的优先级关系
右键菜单里的 “Open Terminal Here” 路径经常不是当前文件所在目录，而是 Sublime 启动时的工作目录——这不是 bug，是插件默认行为。
- 插件会按顺序尝试获取工作目录：
当前文件路径→当前项目根目录→Sublime 启动目录，但前提是文件已保存（未保存的 tab 没有磁盘路径） - 想强制以当前文件目录为准：在插件设置里设
"working_dir": "$file_path"；$file_path是 Sublime 内置变量，未保存文件时为空，此时会 fallback 到项目目录 -
shell_cmd中不能直接写cd $file_path && npm run dev—— Terminal 插件不解析 shell 语法，只执行单条命令。需要封装成脚本或用bash -c "cd ... && ..."
中文乱码、emoji 显示方块？别只改字体，先确认终端编码链
即使设置了 "font_face": "Fira Code"，中文仍显示为 □，问题往往不在字体本身，而在编码协商断层。
- Windows：CMD 默认是 GBK 编码，但插件启动的 shell 进程可能继承 Sublime 的 UTF-8 环境变量，导致解码错位。解决方法是在插件设置里加：
"env": {"PYTHONIOENCODING": "utf-8", "LANG": "zh_CN.UTF-8"} - macOS：检查终端 app 的「高级」设置里是否勾选了「设置环境变量为 UTF-8」；Sublime 自身也要在
Settings里确认"default_encoding": "UTF-8" - Linux：常见于使用
screen或tmux作为 shell 包裹层的情况——插件调起的是外层 shell，但实际渲染走的是 tmux session，需单独配 tmux 的set -g default-shell和set -g default-path
快捷键冲突或失效？sublime-keymap 里的 context 判断很关键
你绑了 ctrl+shift+t 打开终端，结果在输入框里一按就触发，光标还丢了——这是因为 key binding 缺少作用域限制。
- 正确写法必须带
context：
[
{
"keys": ["ctrl+shift+t"],
"command": "terminal",
"context": [
{ "key": "setting.is_widget", "operator": "equal", "operand": false },
{ "key": "setting.auto_complete_visible", "operator": "equal", "operand": false }
]
}
]
is_widget 排除输入框、查找面板等 widget 场景；auto_complete_visible 防止补全弹窗时误触super+shift+t 可能被系统“聚焦到访达”快捷键劫持，需在 macOS 系统设置 → 键盘 → 快捷键 → Mission Control 里关掉对应项Terminal 插件的真正复杂点不在安装，而在它横跨了 Sublime 的生命周期管理、操作系统进程控制、终端模拟器编码协商三层。很多“不工作”的现象，其实是某一层的隐式假设被打破了——比如以为文件路径总存在，或以为 shell 环境和 GUI 环境一致。
