VSCode 1.85+ 已内置稳定括号匹配与着色功能，无需安装 bracket-pair-colorizer-2；该插件已归档，与原生功能冲突会导致颜色错乱、光标跳动及“Cannot read property 'document' of undefined”等错误。
VSCode 1.85+ 版本已内置稳定可靠的括号匹配与着色功能，不需要安装任何第三方括号插件；强行安装 bracket-pair-colorizer-2 反而会引发颜色错乱、光标跳动、Cannot read property 'document' of undefined 等错误。
为什么现在不该装 bracket-pair-colorizer-2
该插件作者已于 2025 年底归档仓库，不再适配 VSCode 新版渲染机制（尤其是 1.70+ 后移除的旧 TextMate 注入 API）。你遇到的“括号不着色”“只高亮一半”“点一下括号就消失”，大概率是它和原生 editor.bracketPairColorization.enabled 功能在抢夺同一段语法标记导致的冲突。
- VSCode 官方从 1.68 开始提供原生括号配对高亮，1.85 起全面优化兼容性与性能
-
bracket-pair-colorizer-2无法识别语言服务提供的语义括号（如 JSX 中的{}或 Vue script 区域），仅做纯文本扫描，易误匹配字符串内的括号 - 插件启用后若报错
Cannot read property 'document' of undefined，基本可锁定为权限被禁用 + 插件未降级适配
怎么正确开启原生括号匹配与着色
直接改设置，不装插件，不重启（部分设置热生效）：
- 打开设置（
Ctrl+,），搜索bracketpaircolorization，勾选Editor > Bracket Pair Colorization: Enabled - 再搜
matchbrackets，把Editor > Match Brackets设为always（不是true，填布尔值会失效） - 如需光标悬停时显示配对连线，开启
Editor > Guides > Highlight Active Bracket Pair - 检查当前文件右下角语言模式是否正确（如
.vue文件应为vue而非plaintext；否则括号不解析）
括号着色失效的常见真实原因
不是插件没装对，而是环境链路断了：
-
language mode错误：.env、自定义模板或无后缀文件被识别为plaintext，原生功能直接跳过括号分析 - 主题覆盖颜色：Monokai 等主题可能重置了
editorBracketHighlight.foreground3等 token 颜色，换回Default Dark+即可验证 - workspace 设置覆盖：项目级
.vscode/settings.json里写了"editor.bracketPairColorization.enabled": false，优先级高于用户设置 - 语言扩展未就绪：Vue 文件需
Volar，Astro 需Astro VSCode，否则 script 区域括号不参与语义匹配
真需要“荧光连线”或深度定制才考虑插件
如果你明确要点击括号弹出连接线、或必须给 <tag> 也上色，那 bracket-pair-colorizer-2 是唯一选择——但必须满足两个前提：
- 卸载所有其他括号类插件（包括旧版
Bracket Pair Colorizer），清空%USERPROFILE%/.vscode/extensions中残留目录 - 降级到兼容版本：目前最后可用的是
v0.0.29（发布于 2024 年中），新版（v0.0.30+）已完全失效
不过得提醒一句：这种连线功能依赖 DOM 注入，在远程开发（SSH/Dev Container）或某些安全策略严格的公司环境中会被直接拦截，稳定性远不如原生方案。
