必须将editor.bracketPairColorization.enabled设为true,否则仅基础高亮;还需同时启用editor.guides.highlightActiveBracketPair和editor.matchBrackets(值为true或"always")才能实现完整彩色分层匹配。
editor.bracketPairColorization.enabled 必须为 true,否则你看到的“匹配括号”只是基础高亮,不是彩色分层——这是绝大多数人配了半天却没效果的根本原因。
为什么括号不自动染色?检查这三项核心开关
vscode 1.60+ 已原生支持多级括号着色,但默认启用 ≠ 实际生效。常被覆盖或禁用的三个关键设置必须同时为真:
-
editor.bracketPairColorization.enabled: 主开关,控制是否启用彩色配对(非简单高亮) -
editor.guides.highlightActiveBracketPair: 决定光标在括号内或紧邻时,是否高亮当前这一对(设为true才有“聚焦感”) -
editor.matchBrackets: 基础匹配开关,值必须是true或"always",不能是false或"near"(后者在深嵌套中极易失效)
常见错误:只开了 bracketPairColorization,却忘了 highlightActiveBracketPair,结果光标一移开颜色就消失,误以为功能坏了。
颜色太淡/看不见?别调主题,先改 workbench.colorCustomizations
深色主题下默认背景色(如 #252526)和括号色几乎无对比,强行换主题反而破坏工作流。直接在 settings.json 中加固视觉提示更可靠:
"workbench.colorCustomizations": {
"editorBracketMatch.background": "#2a303b",
"editorBracketMatch.border": "#ff6b6b"
}
说明:border 比 background 更醒目,尤其在缩进密集区;若仍不明显,可叠加 editor.guides.bracketPairs(设为 true)开启垂直引导线,形成“颜色+边框+竖线”三重定位。
HTML/Markdown 里括号乱染色?精准关闭特定语言
像 注意:该数组是“白名单”的反向逻辑——它表示「仅对这些语言启用」,所以填入 该插件已于 2024 年底停止维护,与 VSCode 1.75+ 的原生 真正需要自定义的场景极少——比如要求第 4 层括号固定为紫色,而原生最多支持 6 层自动轮播配色,已覆盖 99% 的嵌套需求。把精力放在关掉干扰项,比折腾插件更省时间。
bracket pair colorization languages
Edit in settings.json
"editor.bracketPairColorization.languages": ["html", "markdown"]
["html"] 实际等于禁用所有语言(除 HTML),正确做法是明确列出需要保留的语言,如 ["javascript", "typescript", "python"]。装了 Bracket Pair Colorizer 2 却没反应?立刻卸载
bracketPairColorization 存在严重冲突:轻则颜色错乱、层级错位,重则拖慢编辑器响应。官方已明确推荐停用:
Bracket Pair Colorizer 字样的插件settings.json 中没有残留配置如 bracketPairColorizer 相关字段










