BracketHighlighter 必须通过 Package Control 安装，手动复制无效；需确保语法识别正确、启用 match_brackets 系列设置，并在主题中定义对应作用域颜色才能生效。
BracketHighlighter 必须通过 Package Control 安装，手动复制几乎必然失效
Sublime Text 4 及之后版本对插件加载机制做了严格校验，直接把 BracketHighlighter 文件夹拖进 Packages/ 目录，或解压到任意路径，99% 的情况会导致插件不加载、高亮不触发、甚至命令面板搜不到相关命令——这不是配置问题，是 Sublime 拒绝识别未签名/非标准安装的包。
- 唯一可靠路径：先确保
Package Control已正确安装并联网可用；再通过它安装BracketHighlighter - 验证
Package Control是否就绪：按Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Package Control，若下拉列表中出现Package Control: Install Package等选项，说明已就位 - 若控制台报错
ModuleNotFoundError: No module named 'package_control'，说明Package Control损坏或未安装，需重装——在控制台（Ctrl+`）粘贴运行：
import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8'))运行后等待状态栏出现 Package Control: Installed 1 package 提示，再进行下一步。
安装后不生效？先检查语法识别和基础设置是否被覆盖
很多人装完立刻测试，把光标停在 { 上却没反应，第一反应是“插件坏了”，其实大概率是文件没被识别为代码，或内置括号匹配被关掉了。
- 确认当前文件语法正确：右下角状态栏应显示
JavaScript、Python等，而非Plain Text；可手动点击切换（如View → Syntax → Python） - 打开
Preferences → Settings，在右侧用户设置中确保包含以下几项（缺一不可）：
{
"match_brackets": true,
"match_brackets_content": true,
"match_brackets_braces": true,
"match_brackets_square": true,
"match_brackets_angle": false
}"match_brackets_angle": false 特别重要——设为 true 会让 HTML 标签频繁误匹配，干扰 JS/JSON 开发，且与 BracketHighlighter 的标签匹配逻辑冲突。
高亮颜色看不见？不是插件没起作用，是主题没定义对应作用域
BracketHighlighter 默认用 brackethighlighter.curly、brackethighlighter.round 等作用域着色，但绝大多数主题（包括 Monokai、Default）根本没声明这些作用域，结果就是“高亮存在，但完全透明”。
- 快速验证：换一个明确支持该插件的主题，比如
Material Theme或One Dark，安装后在设置里指定：
"color_scheme": "Packages/One Dark/One Dark.sublime-color-scheme"
- 若坚持用原主题，需手动编辑其
.sublime-color-scheme文件（推荐用PackageResourceViewer插件打开），添加类似如下规则：
{
"name": "Curly Bracket Highlight",
"scope": "brackethighlighter.curly",
"background": "#2a4c6d30",
"foreground": "#ffffff"
}注意：scope 名称必须与插件配置中 color 字段一致，否则无效。
想实现彩虹括号？配色和插件配置必须同步改
所谓“彩虹括号”，本质是让不同层级的 {}、[]、() 显示不同颜色。这需要两步同时生效，缺一不可：
- 在
Preferences → Package Settings → BracketHighlighter → Bracket Settings - User中写入分层样式：
{
"bracket_styles": {
"curly": {"color": "brackethighlighter.curly", "style": "highlight"},
"square": {"color": "brackethighlighter.square", "style": "highlight"},
"round": {"color": "brackethighlighter.round", "style": "highlight"}
}
}- 然后在你当前的
.sublime-color-scheme文件里，分别定义这三个作用域的颜色（不能只定义一个，也不能拼错名字） - 常见坑：
style: "highlight"表示背景高亮，若主题背景色太深或太浅，可能看不出差异；可临时换成"outline"或"underline"更易验证是否生效
真正卡住人的从来不是“怎么装”，而是“为什么装了却像没装”——根源往往在主题缺失作用域定义，或用户设置里悄悄关掉了 match_brackets。这两处不查清，装十遍也没用。
