BracketHighlighter 的 bracket_styles 必须显式配置层级颜色，否则三层以上嵌套括号无法区分；需在用户设置中定义 level1–level3 样式，并在主题文件中声明对应 scope，且必须执行 Reload Syntax Definitions 生效。
BracketHighlighter 的 bracket_styles 必须显式配置层级颜色
Sublime Text 4 默认所有括号共用同一高亮色，三层以上嵌套（比如 (function() { return (a => (b => c())); })）时，根本分不清哪对是哪层——这不是主题渲染能力问题，而是 BracketHighlighter 的 bracket_styles 没配。它默认只定义了 default 一种样式，其余层级全 fallback 到同色。
实操建议：
- 打开
Preferences → Package Settings → BracketHighlighter → Bracket Settings – User - 粘贴以下最小可用配置（仅启用四层，避免过度复杂）：
{ "bracket_styles": { "default": {"color": "brackethighlighter.default"}, "level1": {"color": "brackethighlighter.level1"}, "level2": {"color": "brackethighlighter.level2"}, "level3": {"color": "brackethighlighter.level3"} }, "high_visibility_enabled_by_default": true, "match_brackets": true, "match_brackets_braces": true, "match_brackets_square": true, "match_brackets_content": false } - 在
Color Scheme文件中（如Packages/Colorful Theme/Colorful.sublime-color-scheme）确保已定义对应 scope：brackethighlighter.default、brackethighlighter.level1等，且 background 值为不透明十六进制（如"#3a5e8c"），不能是"#00000000"
多光标 + 嵌套括号时高亮错位或消失
当你在多光标状态下把光标停在不同层级的括号上，BracketHighlighter 可能只高亮第一组，或整块区域渲染错位——这通常不是插件 bug，而是 ST4 渲染管线未同步语法定义缓存所致。
实操建议：
- 按
Ctrl+Shift+P输入Reload Syntax Definitions并回车，强制刷新所有语法解析器 - 确认没同时开启原生
match_brackets和BracketHighlighter的冲突模式：若已装BracketHighlighter，请确保用户设置中"match_brackets": true（拼写必须是复数brackets），且不要额外启用"bracket_highlighter.enable": true这类旧版配置项 - 禁用所有非必要视觉插件（如
SyncedSideBar、HighlightWords），它们可能抢占 region 渲染通道，尤其在匿名函数密集区域
JS/TS 中箭头函数括号被误判为 HTML 标签
在 .js 或 .ts 文件里写 a => (b => c)，BracketHighlighter 有时会把 < 和 > 当成标签起止符，导致括号匹配中断甚至报错——这是 match_brackets_angle 开关没关死。
实操建议：
- 在
BracketHighlighter用户设置中明确设为："match_brackets_angle": false - 不要依赖注释掉该行，必须显式写
false；若留空或删掉，插件会按默认值true处理 - 检查当前语法定义是否被篡改：打开命令面板，执行
View: Show Console，输入view.settings().get('syntax')，确认返回的是Packages/JavaScript/JavaScript.sublime-syntax而非自定义或损坏的语法包
括号高亮颜色在深色主题下对比度不足
即使配了 level1–level3，在 Monokai 或 Dracula 类深色主题下，括号边框仍发灰、看不清——根源常是 theme 文件中 brackethighlighter.* scope 的 foreground 或 background 值用了过淡的灰度，或含 opacity 字段。
实操建议：
- 打开当前 color scheme 文件，搜索
brackethighlighter，检查每个 scope 是否有"opacity": 0.5类字段；ST4 不推荐用 opacity 控制高亮，应直接调饱和度和亮度 - 临时验证：切换到官方
Adaptive主题，若嵌套括号立刻清晰可见，则锁定为自定义主题问题 - 安全改法：为每个 bracket_style scope 单独指定
"foreground": "#ff9e54"（橙）/"background": "#2a3b5d"（深蓝），避开主题全局selection样式干扰
