括号匹配高亮需先开启原生设置"match_brackets": true,再配置BracketHighlighter的high_visibility_enabled等参数;颜色须用十六进制,语法识别必须正确,且语法专属设置可能覆盖全局配置。

括号匹配提醒在 Sublime 里分两层:原生功能开对就能用,插件是锦上添花——但很多人装了 BracketHighlighter 却没效果,根本原因是原生开关 match_brackets 被关了,或者压根没配。
为什么光标停在括号上没高亮?先查 match_brackets 是否为 true
Sublime 的括号匹配高亮不是插件驱动的,而是编辑器内置逻辑,开关就一个:match_brackets。它默认值虽是 true,但只要你没在用户设置里显式写出来,Sublime 就不认——哪怕左侧默认设置里有,也不继承。
- 打开
Preferences → Settings,只看右侧「User Settings」面板 - 确保存在且拼写完全正确:
"match_brackets": true(注意结尾有逗号,且不能写成match_bracket) - 顺手加上这几项避免漏掉常见类型:
"match_brackets_braces": true、"match_brackets_square": true、"match_brackets_angle": false(HTML 标签里尖括号误触发太频繁) - 改完保存即生效,不用重启
装了 BracketHighlighter 却没反应?检查 high_visibility_enabled 和语法识别
原生 match_brackets 只在光标“踩”在括号字符上时才高亮;BracketHighlighter 要实现常驻高亮(比如光标在函数名上时,参数括号也一直亮着),必须开 high_visibility_enabled。
- 安装后进入
Preferences → Package Settings → BracketHighlighter → Bracket Highlighter Settings - 在右侧用户配置中加:
"high_visibility_enabled": true - 同时确认
"highlight_style": "outline"或"underline": false,避免下划线干扰阅读 - 右下角查看当前文件语法是否正确(如
.js文件显示为Plain Text,括号规则直接失效;点击它手动选成JavaScript或Vue Component)
高亮颜色太淡、边框看不见?别改主题文件,直给十六进制色值
很多自定义主题根本不维护 brackethighlighter.* 这类 scope,你在主题文件里加一堆 bracket_contents 规则,改了也白改。
- 绕过主题依赖,在
BracketHighlighter设置里直接写颜色:"bracket_styles": {"default": {"color": "ghf84a", "icon": "dot"}} -
color值必须是 6 位或 8 位十六进制(如"#ff4444"或"ff444480"),不能用命名色(如red) - 键名必须严格匹配插件内置定义:
"round"、"curly"、"square"大小写都不能错 - 如果想让括号内整块内容也高亮,加:
"bracket_contents": true,但大 JSON 或 JSX 中建议关掉,避免卡顿
Ctrl+M 跳转正常但高亮不持续?说明 match_brackets 是基础依赖
Ctrl+M 依赖 Sublime 原生匹配逻辑,而 BracketHighlighter 的高亮底层也是靠它定位括号位置。如果 match_brackets 是 false,插件连哪两个字符是一对都识别不了。
- 这不是插件 bug,是设计依赖关系——
BracketHighlighter不替代原生功能,只增强它 - 哪怕你只想用插件的常驻高亮,也必须保证
match_brackets为true,否则high_visibility_enabled彻底失效 - 最容易被忽略的是:某些语法专属设置(如
Settings – Syntax Specific)会悄悄覆盖全局配置,优先级更高,且不报错、不提示
真正卡住人的地方从来不是插件装没装,而是原生开关有没有被语法专属设置静默关掉,或者颜色值写了命名色却以为能生效。这些点不盯住,调再久配置也没用。

















