括号高亮需同时满足原生match_brackets显式启用(拼写正确且为true)、BracketHighlighter插件安装启用、主题定义brackethighlighter.*作用域三者;缺一不可。

括号高亮不是“装了插件就自动亮”,必须同时满足原生开关开启、插件配置生效、主题支持三者,缺一不可;光标停在(或{上没反应,八成是match_brackets没真开,或者拼错成match_bracket(少个s)。
确认 match_brackets 已显式启用且拼写正确
这是整个括号高亮的总开关,Sublime 不会继承默认值——你没亲手写进用户设置里,它就当关着。
-
match_brackets必须设为true,且必须是复数形式:"match_brackets": true;写成match_bracket会彻底失效 - 顺手补全子项更稳妥:
"match_brackets_braces": true(控制{})、"match_brackets_square": true(控制[])、"match_brackets_content": true(高亮括号内整块内容) -
"match_brackets_angle": false建议保持关闭,否则这类标签会在 JS/Python 文件里频繁误触发- 改完保存即生效,无需重启;但 JSON 格式错误(如多逗号、引号不闭合)会导致整段配置被忽略
安装并启用
BracketHighlighter插件原生
match_brackets只闪一下、无边框、不分类型;要常驻、分色、带实线边框,必须靠BracketHighlighter。- 通过 Package Control 安装:按
Ctrl+Shift+P→ 输入Install Package→ 搜索并安装BracketHighlighter(注意大小写,不是旧版bracket_highlighter) - 打开
Preferences → Package Settings → BracketHighlighter → Settings,确保右侧用户设置中包含:"enabled": true和"high_visibility_enabled_by_default": true - 推荐加一行:
"high_visibility_style": "outline",实线边框比背景填充更醒目,尤其在深色主题下 - 若仍不亮,临时禁用其他括号类插件(如
AutoFileName、Tag),它们可能劫持 scope 识别
检查当前主题是否定义了
brackethighlighter.*颜色作用域BracketHighlighter不直接画颜色,而是告诉 Sublime:“请用brackethighlighter.round这个 scope 的样式来渲染”。如果主题没定义,它 fallback 到极浅灰,看起来就像没开。- 临时验证:菜单 →
Color Scheme→ 切到Monokai或One Dark,再试光标停在(上——如果立刻清晰,说明你当前主题缺配色 - 长期解决:用
PackageResourceViewer提取当前主题的.sublime-color-scheme文件,在rules数组末尾添加类似内容:
{ "name": "BracketHighlighter Round", "scope": "brackethighlighter.round", "foreground": "#FFD700", "background": "#2E2E2E" }- 不同括号类型需分别定义:
brackethighlighter.square、brackethighlighter.curly、brackethighlighter.tag(用于 HTML 标签对)右下角语法模式必须是有效语言,不能是 Plain Text
括号匹配规则依赖语法解析器。如果右下角显示
Plain Text,所有括号逻辑都不加载——哪怕配置全对,也完全不响应。- 手动点击右下角语言名,切换为
JavaScript、Python、HTML等对应语言模式 - 中文输入法可能吞掉快捷键,切英文输入法再试
- 某些文件后缀未关联语法(如
.conf、自定义模板),需手动指定语法或配置file_extensions
真正卡住人的,往往不是“怎么配”,而是
match_brackets没显式写、high_visibility_enabled_by_default没设、主题里压根没brackethighlighter.*这行定义——这三个点漏掉任意一个,高亮就形同虚设。











