BracketHighlighter 不生效的根源在于链条式依赖未全部满足：Package Control 未安装或失效、Sublime 内置括号匹配开关关闭、插件自身未启用、主题缺失作用域定义、文件语法未识别、缩进使用 Tab 而非空格。
装 BracketHighlighter 插件本身不难，难的是装完没反应——90% 的人卡在 Package Control 没跑起来，或用户设置里关键开关被关了。
BracketHighlighter 装不上？先验证 Package Control 是否真就绪
手动拖文件进 Packages/ 目录基本无效，Sublime Text 4+ 对插件签名和加载路径有校验。唯一可靠路径是走 Package Control。
- 按
Ctrl + `打开控制台，输入import package_control—— 如果报ModuleNotFoundError: No module named 'package_control'，说明它根本没装好 - 重装用这行（复制粘贴后回车）：
import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8')) - 成功后状态栏会显示
Package Control: Installed 1 package，再按Ctrl + Shift + P输入Package Control: Install Package能搜到才算真正可用
装上了但括号不亮？检查三项硬性开关是否全开
BracketHighlighter 不是“一装就亮”，它依赖 Sublime 内置匹配能力 + 插件自身启用开关同时生效。
- 打开 Preferences → Settings，右侧用户设置中必须包含：
"match_brackets": true、"match_brackets_braces": true、"match_brackets_square": true、"match_brackets_content": true - 打开 Preferences → Package Settings → BracketHighlighter → Settings，确认
"enabled": true且未被注释，"high_visibility_enabled_by_default": true—— 这个不设，高亮只悬停闪一下，嵌套结构根本没法看 -
"match_brackets_angle": false强烈建议保持 false，否则 HTML 标签如<div>会频繁误匹配，干扰 JS/JSON 开发
颜色看不见？不是插件没动，是主题缺作用域定义
BracketHighlighter 默认用 brackethighlighter.round、brackethighlighter.curly 等作用域着色，但 Monokai、Default 等主流主题压根没声明这些作用域，结果就是“高亮存在，但肉眼不可见”。
- 别直接改 .tmTheme 文件——风险高，易破坏其他语法高亮
- 用
PackageResourceViewer提取当前主题（如Monokai.sublime-color-scheme），在Packages/User/下新建同名文件覆盖 - 在里面补上
brackethighlighter.level.1到level.6的 color 定义（每个对应一个 hex 值，如"#FF6188"），顺序错或漏一个都会 fallback 成极浅灰 - 同时在 BracketHighlighter 的用户设置里，把
bracket_styles中各 level 的color设为"brackethighlighter.level.1"等
为什么改完还是不生效？注意两个隐性条件
即使上述都对了，还有两个容易被忽略的点会让配置白做。
- 当前文件必须被识别为代码语法（右下角显示
JavaScript、Python等），而非Plain Text；Plain Text模式下source.js规则根本不加载，插件算不出层级 - 缩进必须用空格，不能用 Tab——Sublime 会直接忽略整个配置块，连带彩虹括号也失效
- 保存主题或设置后，要关闭再重开当前文件才生效；重启 Sublime 有时也不管用
最常被卡住的地方不是不会装，而是以为“装了=好了”，其实 BracketHighlighter 是个链条：Package Control → 内置 match_brackets → 插件 enabled → 主题作用域定义 → 语法识别正确 → 缩进合规。断任意一环，括号就安静如初。
