VSCode 1.85+ 已内置稳定括号配对功能，禁用 bracket-pair-colorizer-2 可缓解卡顿，因其依赖已移除的 TextMate API，导致主线程正则扫描、CPU 升高、与原生功能抢夺 token 引发重绘冲突。
VSCode 1.85+ 版本已内置稳定括号配对功能，bracket-pair-colorizer-2 不仅无效，还会直接引发卡顿、光标跳动和 Cannot read property 'document' of undefined 报错——这不是配置问题，是插件与原生机制硬冲突。
为什么禁用 bracket-pair-colorizer-2 能立刻缓解卡顿
该插件在 VSCode 1.70+ 后已彻底失配新渲染链路，它仍依赖已被移除的 TextMate 注入 API，强行运行会导致：
- 持续占用主线程做低效正则扫描（非 AST 级匹配），CPU 占用飙升
- 与原生
editor.bracketPairColorization.enabled抢占同一语法 token，触发反复重绘 - 在 Vue/JSX 等语义区域完全失效，却仍在后台监听所有文件变更，徒增 I/O 压力
如何确认当前卡顿是否由它引起
打开命令面板（Ctrl+Shift+P），运行 Developer: Show Running Extensions，重点关注：
- 查找
bracket-pair-colorizer-2或Bracket Pair Colorizer条目，看其Startup Time是否 >150ms、CPU列是否频繁跳动 - 若状态为
Running且内存占用 >100MB，基本可锁定为元凶 - 右下角语言模式显示为
vue或typescriptreact时，括号着色错位/消失，大概率是它在干扰语义解析
停用后必须检查的三项设置
禁用插件只是第一步，原生功能需手动激活并排除干扰：
- 打开设置（
Ctrl+,），搜索bracketpaircolorization，确保Editor > Bracket Pair Colorization: Enabled已勾选 - 再搜
matchbrackets，将Editor > Match Brackets设为always（填true会失效） - 检查项目级
.vscode/settings.json，确认没有"editor.bracketPairColorization.enabled": false这类覆盖项
中文括号或特殊符号需要额外处理
原生功能默认只识别 ASCII 括号（()、[]、{}），中文括号需语言扩展支持：
- 【】、『』等无法靠
bracket-pair-colorizer-2可靠渲染——它连字符串内括号都分不清，极易误匹配 - 真正可行的方案：用
editor.matchBrackets+ 语言扩展定义（如 Volar 对 Vue 中【】的支持），或改用Bracket Pair Tamer（专为混合括号设计） - 若坚持用插件方案，必须先在用户设置中关闭原生：
"editor.bracketPairColorization.enabled": false，否则必然冲突
最容易被忽略的是语言模式——哪怕所有设置都对，只要右下角显示 Plain Text，括号解析就根本不会启动。每次打开新文件、粘贴代码、或切换分支后，都值得扫一眼那个小标签。
