brackethighlighter 必须通过 package control 安装,手动复制无效;需启用 match_brackets 系列设置、high_visibility_enabled_by_default,并确保语法正确及主题定义 brackethighlighter.level.1–6 颜色。

BracketHighlighter 必须用 Package Control 装,手动复制不管用
Sublime Text 4 及之后版本拒绝加载非标准路径的插件,直接把 BracketHighlighter 文件夹拖进 Packages/ 目录,99% 的情况不会生效——不是你操作错,是 Sublime 根本不认。
唯一可靠路径:
- 先确认
Package Control已就绪:按Ctrl + Shift + P(macOS 是Cmd + Shift + P),输入Package Control,能看到Package Control: Install Package才算正常 - 如果控制台(
Ctrl + `)里执行import package_control报ModuleNotFoundError,粘贴这行重装:import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8')) - 装完再搜
BracketHighlighter安装,别选旧名bracket_highlighter(大小写、下划线都错不得)
match_brackets 系列设置必须全开,拼错一个就失效
原生括号匹配是插件生效的前提,但很多人只开了 match_brackets,漏掉关键项,结果光标停在 { 上没反应。
打开 Preferences → Settings,用户设置里必须显式包含:
-
"match_brackets": true(注意是复数brackets,写成match_bracket就白配) -
"match_brackets_braces": true(否则{}不匹配) -
"match_brackets_square": true(否则[]不亮) -
"match_brackets_angle": false(设为true会让<div> 频繁误触发,干扰 JS/JSON)<p>改完保存即生效,不用重启 Sublime。</p> <h3>high_visibility_enabled_by_default 不开,高亮只闪一下</h3> <p><code>BracketHighlighter默认只在悬停时高亮,移开光标就消失——这不是 bug,是默认行为。要让括号“常驻可见”,必须开这个开关。打开
Preferences → Package Settings → BracketHighlighter → Settings,确保有:-
"enabled": true(插件本身启用) -
"high_visibility_enabled_by_default": true(关键!不开就永远只闪) -
"high_visibility_style": "outline"(推荐实线边框,比背景色更醒目,尤其深色主题下)
顺带检查:右下角语法显示是不是
Plain Text?如果是,点它手动选JavaScript或对应语言,否则插件压根不启动。主题没定义 brackethighlighter.* 作用域,颜色就是灰的
插件算出哪层是
level_1、哪层是level_6,但最终颜色全靠主题文件里的brackethighlighter.level.1到level.6定义——缺一个,那一层就 fallback 成极浅灰,嵌套根本分不清。稳妥做法(别硬改 .tmTheme):
- 用
PackageResourceViewer提取当前主题(比如Monokai.sublime-color-scheme) - 在
Packages/User/Monokai.sublime-color-scheme里添加brackethighlighter.level.1到level.6的 color 值,例如:"#FF6188"、"#AB9DF2" - 每个 level 对应一个 hex 值,顺序不能乱,重复或漏写会导致某层变灰
- 缩进必须用空格,不能用 Tab,否则整个配置块被 Sublime 忽略
- 改完保存后,关掉文件再重开才生效,重启 Sublime 有时也不管用
最常被忽略的一点:括号层级计算依赖语法作用域识别,而
Plain Text模式下source.js规则根本不加载——哪怕配置全对,语法不对也白搭。 -











