不推荐新装 BracketHighlighter。它已多年未维护,最后一次更新是2019年,与Sublime Text 4现代API兼容性差,易导致高亮错位、引号不响应及AttributeError错误。

BracketHighlighter 插件是否还值得装?
不推荐新装 BracketHighlighter。它已多年未维护,最后一次更新是 2019 年,与 Sublime Text 4 的现代 API(如 view.find_by_selector()、on_query_context)兼容性差,容易导致括号高亮错位、引号不响应、甚至触发 AttributeError: 'NoneType' object has no attribute 'begin' 类错误。
用原生功能替代自动配对和高亮
Sublime Text 3/4 自带的括号行为已足够可靠,无需插件即可实现:自动补全成对符号、光标悬停高亮匹配项、选中时高亮整个结构块。
- 启用自动配对:
Preferences → Settings中确保"auto_match_enabled": true(默认开启) - 输入
(、[、{、"、'会自动插入右半边,光标停在中间 - 将光标放在任一括号或引号上,匹配项会高亮(受当前 color scheme 支持程度影响)
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Select Scope可快速选中整个括号包裹内容
如果非要高亮嵌套层级,改用 BracketHighlighter 的现代替代品
推荐安装 BracketHighlighter2(社区维护分支)或更轻量的 AutoSetSyntax 配合原生高亮。但注意:
-
BracketHighlighter2不再通过 Package Control 分发,需手动克隆到Packages/目录:git clone https://github.com/facelessuser/BracketHighlighter.git "BracketHighlighter"
- 安装后必须禁用原版
BracketHighlighter,否则冲突 - 它的高亮规则依赖
scope,若你用的是自定义 syntax 或非标准引号(如中文引号、模板字符串中的`),需手动修改bracket_highlighter.sublime-settings中的brackets数组 - 性能敏感项目(如打开 >50MB 的日志文件)建议关闭
"highlight_when_idle": false
常见高亮失效场景和修复方式
即使启用原生高亮,也常遇到“光标放上去没反应”——这几乎全是 scope 解析问题,不是插件故障。
- 文件未正确识别语法:检查右下角是否显示
Plain Text,应手动设为JavaScript/Python等;或确认文件扩展名是否被 syntax 规则覆盖 - color scheme 不支持 bracket highlight:换用
Monokai、Adaptive等内置主题,或编辑当前 theme 的.sublime-color-scheme,添加"brackethighlighter.unmatched"和"brackethighlighter.curly"等 scope 样式 - 引号高亮异常(比如单引号不亮双引号亮):Sublime 默认只高亮配对的 ASCII 引号;若需支持
"""或 f-string 中的f",需配合Enhanced Newlines或修改 syntax definition
meta.brace.round.python 这类 scope,一旦 syntax 写得松散(比如把括号归为 constant.character),高亮就断了。这点比插件配置更关键,也更容易被忽略。










