快捷键仅在HTML文件生效的关键是用context匹配语法作用域text.html.basic,而非文件后缀;需通过Inspect Syntax确认真实scope,context必须为数组且含key、operator、operand三字段。

怎么让快捷键只在 HTML 文件里生效
关键不是“加个条件”,而是用 context 精确匹配语法作用域。Sublime 不认文件后缀,只看右下角显示的语法名(比如 text.html.basic),这个值必须和 selector 字段完全一致。
常见错误是写成 "operand": "html" 或 "operand": "*.html"——这些都不起作用。正确写法要查真实作用域:
- 打开一个 HTML 文件,按
Ctrl+Shift+P输入Inspect Syntax,回车,看控制台输出的scope:值 - 多数情况下是
text.html.basic,但如果是 Vue 单文件组件里的 template 区域,可能是text.html.vue -
context必须写成数组形式,且每个对象都要有key、operator、operand
示例(仅对 HTML 文件启用格式化):
[{
"keys": ["ctrl+alt+f"],
"command": "html_css_js_prettify",
"context": [
{
"key": "selector",
"operator": "equal",
"operand": "text.html.basic"
}
]
}]
为什么 JS 文件里按了快捷键没反应
最常漏掉的是 context 中的 selection_empty 判断。很多格式化插件(比如 html_css_js_prettify)默认要求「无选区」才全文件格式化;一旦你选中了某段代码,它就静默跳过。
如果你希望「有选区时格式化选区,没选区时格式化全文」,就得显式放开这个限制:
- 删掉
selection_empty条件,或把它设为"operand": false - 或者干脆不加
selection_empty,只留selector匹配 - 注意:有些插件(如
JsFormat)根本不支持选区格式化,只响应全文件操作
另一个坑是语法识别失败:JS 文件右下角显示 Plain Text,selector 再准也白搭。先确认语法是否正确(Ctrl+Shift+P → Set Syntax: JavaScript)。
多个语法共用一个快捷键怎么写
不能靠逗号拼接,要用 |(管道符)在 operand 里写正则式。Sublime 的 selector 支持简单正则,| 表示“或”关系。
例如同时支持 JS、CSS、HTML:
"operand": "source.js|source.css|text.html.basic"
但要注意顺序和优先级:
- 作用域匹配是“最长前缀优先”,
source.js.jsx会比source.js更先命中 - 如果混用 Vue/TS,建议拆成多条规则,避免
operand过长难调试 - 别写
"operand": "source.*"——通配符*在 selector 里不被支持
reindent 和插件命令的 context 差异在哪
reindent 是 Sublime 原生命令,它对 context 的依赖更松:只要当前视图语法是 source.python 或 source.js,哪怕没写 context,也能工作。但第三方插件(如 html_css_js_prettify)几乎都强制校验 context,漏一条就失效。
根本区别在于执行时机:
-
reindent在按键按下时直接调用编辑器底层缩进引擎,不走语法高亮 pipeline - 插件命令通常先检查
context,再 spawn Node 进程或加载配置,任一环节失败都静默退出 - 所以插件类快捷键出问题,第一反应不是查 JSON 格式,而是看
context是否完整覆盖目标场景
复杂点在于:同一个快捷键组合,在不同语法下可能触发不同命令(比如 ctrl+shift+r 在 Python 里调 reindent,在 HTML 里调 html_css_js_prettify),这时必须用多条规则 + 精确 context 隔离,不能指望一条规则通吃。











