BracketHighlighter装不上需先确认Package Control是否正常：控制台输入import package_control，报错则重装；装好后检查状态栏提示及两项启用开关；高亮不显多因主题未定义brackethighlighter.*作用域。

BracketHighlighter 装不上？先确认 Package Control 活着

插件装不成功，90% 的问题出在 Package Control 根本没跑起来——它不是“自带的”，而是必须手动装、且容易静默失败的底层依赖。

• 按 Ctrl + ` 打开控制台，输入 import package_control；如果报 ModuleNotFoundError，说明 Package Control 损坏或压根没装
• Sublime Text 4 推荐用这一行重装（粘贴后回车）：import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8'))
• 装完别急着搜插件——看状态栏是否出现 Package Control: Installed 1 package；没出现就重试，重启 Sublime 也没用

装完 BracketHighlighter 却没反应？检查两个开关

插件安装成功 ≠ 自动接管括号高亮。Sublime 有两层控制：内置匹配开关 + 插件启用开关，任一关闭都会“黑屏”。

• 打开 Preferences → Settings，确保用户设置里有："match_brackets": true（否则光标靠近括号连闪都不闪）
• 打开 Preferences → Package Settings → BracketHighlighter → Settings，确认 "enabled": true；有些主题或旧配置会把它设为 false
• 别信“装完自动生效”——打开一个 .py 或 .js 文件，把光标精准停在 { 上再试；停在空格或换行符上，插件直接无视

高亮太淡/看不见？不是插件问题，是主题缺定义

BracketHighlighter 的颜色名（比如 brackethighlighter.curly）只是个“标签”，最终显示效果完全取决于当前 color scheme 文件里有没有对应的作用域定义。

• 很多自定义主题（尤其是轻量版或 DIY 主题）压根没写 brackethighlighter.* 这类作用域，导致高亮“存在但透明”
• 临时验证方法：在 BracketHighlighter 用户设置里把颜色改成十六进制值，例如 "color": "#FF5733"，绕过主题查找逻辑
• 长期方案：编辑你当前的 .sublime-color-scheme 文件，在 rules 数组里加几条，比如：

  {
    "name": "Bracket Highlighter: Curly",
    "scope": "brackethighlighter.curly",
    "foreground": "#FF5733"
  }

想实现彩虹括号？关键不在插件配置，而在层级样式+主题联动

BracketHighlighter 本身不生成“彩虹”，它只按嵌套深度分配 level_1、level_2 等样式名；要真看到不同颜色，必须让这些名字在主题里被分别定义。

• 在 BracketHighlighter 用户设置中加入 level_1 到 level_6 的 bracket_styles 条目，但注意：它们只是“占位符”，不配色=白搭
• 每个 level_n 对应的颜色（如 brackethighlighter.level.3）必须在 color scheme 中显式声明，否则 fallback 到默认色（常是灰色）
• 别漏掉 "high_visibility_enabled_by_default": true，否则只悬停时才亮，嵌套深了根本分不清哪层是哪层

最常被忽略的一点：括号类型（curly、round）和嵌套层级（level_1）是两套独立系统，不能混用；想靠颜色区分 {} 和 ()，就得配 curly 和 round；想靠颜色区分嵌套深度，就得配 level_1 到 level_6，并确保主题全定义了。