BracketHighlighter不亮的根本原因是match_brackets未开启、high_visibility_enabled_by_default未设为true,或主题未定义brackethighlighter.*作用域;需依次确认Package Control正常、原生匹配开关启用、插件持久高亮开启及主题配色完整。

BracketHighlighter 装上不亮,不是插件坏了,而是 Sublime 的括号高亮链路断在了最前面——match_brackets 没开、high_visibility_enabled_by_default 没设为 true、或者当前主题压根没定义 brackethighlighter.curly 这类颜色作用域。
为什么光标停在 { 上没反应?先查 match_brackets 开关
这是所有问题的起点。BracketHighlighter 不是独立运行的高亮器,它依赖 Sublime 原生的括号匹配触发逻辑。如果 match_brackets 是 false 或拼错成 match_bracket(少 s),整个插件连初始化都不会做。
-
Preferences → Settings右侧用户设置中必须有:"match_brackets": true - 顺手加上:
"match_brackets_braces": true(控制{})、"match_brackets_square": true(控制[]) -
"match_brackets_angle": false建议保持关闭,否则 HTML 标签如<div> 会被误判,干扰 JS/Python 编辑 <li>改完保存即生效,不用重启 Sublime</li> <li>常见错误现象:光标停在 <code>{上,另一边没高亮,或只闪一下就消失——大概率就是这个开关没开,或者被其他插件配置覆盖了 - 打开
Preferences → Package Settings → BracketHighlighter → Settings – User - 在用户配置中加入:
"high_visibility_enabled_by_default": true - 推荐加一行:
"high_visibility_style": "outline"(实线边框比背景色更轻量,不遮挡代码) - 可选增强:
"high_visibility_extra_offsets": ["left", "right"]让边框左右多延展一点,更易识别 - 若仍无效,临时禁用其他括号相关插件(如 AutoFileName、Tag),它们可能劫持了 scope 识别
- 用命令面板
Ctrl+Shift+P输入Color Scheme → Open Color Scheme,找到当前主题(如Monokai.sublime-color-scheme) - 复制一份到
Packages/User/下并重命名(防升级覆盖) - 在新文件里搜
"scope": "bracket"或"name": "Bracket",修改background(底色)和foreground(括号字符色) - 注意:有些主题把不同括号拆成
bracket.round、bracket.curly等 scope,得一并检查,否则只改了圆括号,大括号还是灰扑扑的 - 快速验证法:在 BracketHighlighter 用户设置里加一行
"color": "#FF5252",如果边框立刻变红,就坐实是主题缺配置 - 按
Ctrl + `打开控制台,输入import package_control - 如果报
ModuleNotFoundError,说明它根本不存在 - Sublime Text 4 推荐用这行重装(粘贴后回车):
import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8')) - 装完别急着搜插件:按
Ctrl + Shift + P输入Package Control,能调出Package Control: Install Package才算真正就绪 - BracketHighlighter 安装成功 ≠ 自动高亮,必须同时满足三项硬性条件:
match_brackets为true、high_visibility_enabled_by_default为true、当前主题定义了对应brackethighlighter.*作用域
high_visibility_enabled_by_default 必须设为 true
原生 match_brackets 只在光标悬停时短暂闪烁;BracketHighlighter 默认行为也一样。想让它“一直亮着”,看清嵌套结构,必须手动打开持久高亮开关。
高亮太淡或根本看不见?别改插件配置,去动主题文件
BracketHighlighter 的 bracket_styles 配置项(比如 "brackethighlighter.default")只是引用名,真正决定颜色的是你当前使用的 .sublime-color-scheme 文件。改插件配置 ≠ 改颜色,这是最常踩的坑。
安装前先确认 Package Control 活着吗?
Sublime 不自带插件管理器,所有“一键安装”都依赖 Package Control。它可能静默损坏——状态栏看着正常,但实际无法加载插件列表。
最容易被忽略的是 scope 识别问题:JSX、Vue、Markdown 中括号不亮,大概率不是插件失效,而是右下角语法显示为 Plain Text。光标必须精准落在括号字符上,不能停在空格或选中文本中——这点在深嵌套或缩进混乱的代码里特别容易栽跟头。

















