bracket-matcher功能异常的三大主因是插件未启用、语法scope识别错误或深色主题覆盖高亮样式；需依次检查启用状态、手动切换grammar、追加styles.less高亮规则，并注意tree-sitter冲突。
Atom 的 bracket-matcher 插件默认启用，但括号高亮、跳转、自动补全这三项功能常“看起来没反应”——不是插件坏了，而是它被压制、语法没识别、或样式被主题吃掉。直接查这三处，90% 问题当场解决。
bracket-matcher 是否真在运行
它虽是内置插件，但可能被手动禁用，或被其他插件静默接管。别只看“已安装”，要确认它正在工作。
- 打开 Settings → Packages，搜索
bracket-matcher，右侧状态必须是 Enabled（蓝色），不是灰色Disabled或Install - 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入Bracket Matcher: Toggle执行一次；若高亮/补全立刻恢复，说明功能完好，只是被压制 - 终端执行
atom --safe启动（禁用所有社区插件），再试括号行为；若恢复正常，问题一定出在某个已启用插件上 - 重点排查：
vim-mode-plus（劫持Cmd+M）、parinfer（接管括号结构）、tree-sitter-syntax（覆盖匹配逻辑）
当前文件是否被 Atom 正确识别为代码
括号匹配只对 Atom 明确认知的语法 scope 生效。如果右下角显示 Plain Text、text.html.vue 或 source.js.jsx 这类泛化 scope，匹配逻辑根本不会触发。
- 点击右下角语法名称，手动选对的 grammar，比如 Vue 文件选
Vue Component，JSX 文件选JavaScript (JSX) - 确保对应 language 插件已安装并启用：如
language-vue（让.vue解析为source.vue）、language-javascript（支持 JSX）、language-python - 注意：
language-vue若未正确加载，.vue文件会 fallback 到text.html.vue，此时括号层级解析受限，匹配失效
高亮颜色太淡或完全看不见
深色主题常把 .bracket-matcher .region 的 background-color 设成接近背景的浅灰，肉眼不可见。这不是功能失效，是样式被覆盖或透明度太低。
- 打开 Atom → Application: Open Your Stylesheet（自动打开
~/.atom/styles.less） - 在末尾追加这段规则（适配深色主题）：
.bracket-matcher .region { background-color: rgba(100, 200, 255, 0.4) !important; border: 1px solid #64c8ff !important; } -
!important必须保留，否则被主题 CSS 覆盖；rgba第四个值（透明度）建议 ≥ 0.4，低于 0.2 在深色主题下基本不可见 - 别碰
.syntax--punctuation或core.highlight-line—— 它们和括号匹配无关
Ctrl+M / Cmd+M 跳转失灵的硬性条件
这个快捷键不是“找最近一对括号”，而是严格绑定光标所在字符。不满足以下任一条件，就必然无响应。
- 光标必须精确停在
(、)、[、]、{或}这六个字符上；停在空格、字符串内、注释中、甚至紧邻括号的字符后，都无效 - 启用 Tree-sitter（Settings → Core → Use Tree Sitter Parsers）后，
bracket-matcher的跳转和高亮会退化甚至完全失效；验证方法：临时关闭 Tree-sitter，重启 Atom 再试 - 按快捷键前，打开 Key Binding Resolver（
Ctrl+.或Cmd+.），再按Cmd+M，看右边是否显示绑定到bracket-matcher:toggle-bracket；若显示被其他插件劫持，就得调整 keymap - Python、YAML 等无显式括号块的语言，
bracket-matcher对:或缩进块不做处理——这不是缺陷，是机制限制
真正容易被忽略的是 Tree-sitter 和语法 scope 的双重压制：哪怕 bracket-matcher 显示启用，只要启用了 Tree-sitter 解析器，且当前文件 scope 是 text.html.vue，那括号匹配就等于没启动。改 styles.less 只能救颜色，救不了逻辑断层。
