BracketHighlighter 必须通过 Package Control 安装，手动复制易失效；安装后无需重启，但需确保语法正确、主题支持brackethighlighter.*作用域，配色需同步修改插件配置和主题文件。
BracketHighlighter 默认不自带，必须通过 Package Control 安装——这是唯一稳定、可更新的途径。手动复制插件文件或拖入 Packages 目录容易因路径/权限/版本错位导致高亮失效，尤其在 Sublime Text 4 上基本不可靠。
确认 Package Control 已就绪
很多“安装失败”其实卡在这步：Package Control 没装好，或被墙导致列表加载为空。
- 按
Ctrl+`（Windows/Linux）或Cmd+`（macOS）打开控制台，粘贴运行（Sublime Text 4 推荐）：import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8')) - 安装后重启 Sublime；若状态栏没出现
Package Control: Installed提示，说明网络异常——需手动下载channel_v3.json放到Installed Packages同级目录的Channels文件夹中（路径见知识库） - 验证是否成功：按
Ctrl+Shift+P输入Package Control，能看到下拉菜单里有相关命令
安装 BracketHighlighter 并验证基础功能
插件本身安装极快，但「没反应」常因用户误以为要重启或手动启用。
- 按
Ctrl+Shift+P→ 输入Install Package→ 选中Package Control: Install Package - 等待几秒（左下角显示“Loading package list…”），输入
BracketHighlighter，点击安装 - 安装完成无需重启——立刻打开一个
.js或.py文件，把光标停在{、(或[上，匹配括号应自动加框或变色 - 若无反应：检查是否用了极简主题（如
Monokai默认不定义brackethighlighter.*作用域），或当前语法未被识别（如文件没设为 Python 语法，而是 Plain Text）
让括号真正“彩虹化”：配色与样式配置
默认高亮只是单色框线，所谓“彩虹括号”需两步配合：一是插件配置不同括号类型样式，二是主题文件中定义对应颜色名。
- 打开配置：菜单 →
Preferences → Package Settings → BracketHighlighter → Bracket Settings - User - 写入最小可用配置（只改
style和color）：{ "bracket_styles": { "curly": {"color": "brackethighlighter.curly", "style": "highlight"}, "round": {"color": "brackethighlighter.round", "style": "highlight"}, "square": {"color": "brackethighlighter.square", "style": "highlight"} } } - 接着打开你当前使用的主题文件（如
Monokai.tmTheme），在<array>内添加颜色定义：<dict> <key>name</key> <string>Bracket Highlighter: Curly</string> <key>scope</key> <string>brackethighlighter.curly</string> <key>settings</key> <dict> <key>foreground</key> <string>#FF6B6B</string> </dict> </dict>其他括号同理，换不同scope和foreground值即可
常见失效场景与绕过方案
不是所有代码都能被正确识别括号层级，尤其在字符串、正则、模板字面量中，BracketHighlighter 可能“看走眼”。
- JS 中反引号字符串里的
{}会被误判为对象起点 → 在配置中加入"ignore_brackets": ["string", "comment"] - HTML 标签嵌套过深时高亮延迟或错位 → 关闭
"high_visibility_enabled"（该选项会强制重绘，反而加重卡顿） - 想省事获得彩虹效果？直接换主题：
Material Theme + Afterglow或Neon Color Scheme已预置全部brackethighlighter.*颜色，装完即用
配色必须同时改插件配置和主题文件，缺一不可；很多人只改了 JSON 就以为完事，结果括号还是灰扑扑的——这不是 bug，是 Sublime 的作用域机制决定的。
