brackethighlighter无法使用需分三步排查：先确认package control是否正常运行并重装；再检查插件及原生括号匹配的双重开关是否开启；最后验证主题color_scheme是否定义了对应bracket scope，必要时手动补全或切换主题。
BracketHighlighter装不上？先确认Package Control真在跑
插件根本没装上，90% 是 Package Control 静默失效——状态栏显示正常，但 Ctrl + Shift + P 输入 Package Control: Install Package 报错或搜不到，就是它挂了。
按 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，能列出子命令才算真正就绪 - 重装后仍不生效，检查
Packages/Package Control/目录是否存在，空目录或只有 .pyc 文件说明加载失败
BracketHighlighter装上了但括号不亮？三个开关必须全开
插件安装 ≠ 自动接管高亮。Sublime 有两层开关：原生匹配能力 + 插件启用逻辑，缺一不可。
打开 Preferences → Settings（用户设置），确认含这三项：
-
"match_brackets": true（注意是复数brackets，写成match_bracket就彻底失效） "match_brackets_braces": true"match_brackets_square": true
再打开 Preferences → Package Settings → BracketHighlighter → Settings，确认：
-
"enabled": true（未被注释、值为布尔true） -
"high_visibility_enabled_by_default": true（不设这个，光标移开就消失，嵌套结构没法看）
高亮“存在但看不见”？主题 color_scheme 没配 bracket scope
BracketHighlighter 默认用 brackethighlighter.curly 这类 scope 名去查主题颜色定义。很多主题压根没定义这些 scope，或者只定义了 bracket 却漏掉 bracket.curly，结果大括号不亮、圆括号亮——不是插件问题，是主题缺字段。
快速验证：在 BracketHighlighter 用户设置里加一行："color": "#FF5252"
如果边框立刻变红，就坐实是主题颜色缺失。
- 右下角点击语法名 → 切换到
Adaptive或Default主题，立刻看是否恢复高亮 - 确认是主题导致后，用
PackageResourceViewer: Open Resource复制当前主题文件到Packages/User/下再改，搜索"bracket"或"brackethighlighter"，补全bracket.round、bracket.curly等 scope 的background值
JSX/Vue/Markdown 里括号不亮？Syntax scope 识别错了
BracketHighlighter 依赖 Sublime 的语法解析器输出的 scope。JSX 中 {} 被识别成 meta.brace.curly.js，而默认规则只匹配 meta.brace.curly；Vue 的 <template></template> 块里括号可能被归为 text.html.vue，规则不覆盖。
临时验证：新建一个纯 .js 文件，把光标精准停在 { 字符上（不能停在空格、换行或选中文本中）——亮了，说明是 scope 问题。
- 右下角显示
Plain Text？按Ctrl + Shift + P→ 输入Set Syntax: JavaScript手动指定 - 需要支持 JSX，得在 BracketHighlighter 设置里扩展
scopes列表，加"source.js.jsx"；Vue 同理加"text.html.vue" - 别盲目删插件，先关掉其他语法高亮类插件（如 Babel、Vue Syntax Highlight），排除干扰
bracket_styles 里每个括号类型都可单独定义 color 和 style，但前提是 theme 文件里对应 scope 存在且可被正确引用。很多人卡在“改了设置没反应”，其实是 theme 和 plugin 的 scope 名没对齐——这点比插件本身更难调试。
