<p>BracketHighlighter 高亮失效主因是配置未启用或主题缺配色：需开启 match_brackets 系列选项、设置 high_visibility_enabled_by_default 为 true，并在主题中定义 brackethighlighter.* 颜色或直接用十六进制色值配置 bracket_styles。</p>

BracketHighlighter 能让括号高亮真正“看得见、分得清、靠得住”，但装上就有效果只是幻觉——多数人卡在 match_brackets 关着、high_visibility_enabled_by_default 没开、或当前主题根本没定义 brackethighlighter.curly 这类颜色名。

确认原生括号匹配已启用（否则插件不接管）

BracketHighlighter 不是替代原生功能，而是增强它。如果 match_brackets 是 false，光标靠近括号时连最基础的闪烁都没有，插件压根不会触发高亮逻辑。

• match_brackets 必须为 true
• match_brackets_braces 和 match_brackets_square 也要设为 true，否则 {} 和 [] 不响应
• match_brackets_angle 建议保持 false，避免 HTML 标签里频繁误高亮 <div> <li>这些配置加在 <code>Preferences → Settings 的右侧用户设置中，保存即生效，不用重启

安装后没反应？重点检查 high_visibility_enabled_by_default

BracketHighlighter 默认只在光标悬停瞬间高亮，松开就消失——这不是 bug，是默认行为。想让它“一直亮着”，必须手动打开持久高亮开关。

• 打开 Preferences → Package Settings → BracketHighlighter → Settings
• 在用户配置中加入："high_visibility_enabled_by_default": true
• 顺手加上 "high_visibility_extra_offsets": ["left", "right"]，让边框左右多延展一点，更易识别
• 若仍无效，临时禁用其他括号相关插件（如 AutoFileName、Tag），它们可能劫持了 scope 识别

括号高亮颜色太淡？不是插件问题，是主题缺配色

BracketHighlighter 依赖主题文件里的颜色定义，比如 brackethighlighter.round。很多自定义主题压根没写这一行，插件 fallback 到极浅灰色，看起来就像没开。

• 临时验证：切换到内置主题 Monokai 或 Adaptive，看是否立刻清晰 —— 如果是，说明你当前主题缺配置
• 长期解决：用 PackageResourceViewer 提取当前主题的 .sublime-color-scheme 文件
• 在 rules 数组里加一段（注意 scope 要覆盖三类括号）：

  {
    "name": "Bracket Highlight",
    "scope": "meta.brace.round, meta.brace.square, meta.brace.curly",
    "foreground": "#FF5555",
    "background": "#282C3430",
    "bold": true
  }

嵌套多层括号分不清？靠 bracket_styles 分类型配色

默认所有括号都用同一种颜色，三层以上嵌套基本靠猜。BracketHighlighter 支持按括号类型分别配色，但键名必须严格匹配内置定义，且顺序影响优先级。

• 支持的键名只有这几个：round、curly、square、angle、single_quote、double_quote，拼错一个都不生效
• 在 Bracket Highlighter Settings – User 中配置："bracket_styles": { "curly": { "color": "#FF5555", "style": "outline" }, "round": { "color": "#4ECDC4", "style": "solid" } }
• 用十六进制色值（如 "#FF5555"）比用主题色名（如 "brackethighlighter.curly"）更稳妥，绕过主题缺失风险
• 注意：JSX 或 Vue 中的 {} 属于 source.js scope，若不生效，需检查 scope_exclude 是否误排除了 source

真正难的不是装插件，而是理解 BracketHighlighter 和 Sublime 原生括号逻辑、主题配色系统、语法 scope 三者之间的协作关系。漏掉其中一环，高亮就变成“好像开了，又好像没开”的玄学状态。