bracket-matcher插件失效主因是被atom-Parinfer、tree-sitter-syntax等插件覆盖；其仅支持基础配对高亮与跳转，不支持嵌套着色或智能语法树可视化，需按规范配置并重启生效。
bracket-matcher 插件没生效？检查是否被其他插件覆盖
Atom 默认自带 bracket-matcher，但如果你装了 atom-Parinfer、tree-sitter-syntax 或某些语言专用高亮包（比如 language-vue-component），它们可能接管括号逻辑，导致原生匹配失效或颜色错乱。
- 打开 Atom 设置 → “Packages”，搜索
bracket-matcher，确认状态是 Enabled（不是灰色禁用） - 临时禁用
atom-Parinfer和tree-sitter-syntax（官方明确标注“实验性，不要使用”）再测试 - 若用 Tree-sitter 语法高亮（如启用了
language-rust的 tree-sitter 模式），括号匹配会走 Tree-sitter 路径，此时bracket-matcher的高亮和跳转可能不触发 —— 这不是 bug，是设计使然
括号颜色不区分嵌套层级？原生不支持，得靠主题或扩展补足
Atom 自带的 bracket-matcher 只做「配对高亮」和「跳转」，不提供多层着色。它不会像 VSCode 的 editor.bracketPairColorization.enabled 那样按深度分配 #FF6B6B、#4ECDC4 等颜色。
- 想实现嵌套着色：只能换主题（如
one-dark-ui+one-dark-syntax组合稍好）或安装第三方包，例如rainbow-csv不适用，但highlight-selected也帮不上忙 —— 实际上 Atom 生态里没有稳定维护的 Bracket Pair Colorizer 类扩展 - 别在
~/.atom/packages/bracket-matcher/styles/下手动改 CSS：新版 Atom 已弃用该路径，样式会被忽略 - 替代方案：启用
editor.showInvisibles: true并配合缩进引导线，能间接强化结构感知，比硬改括号颜色更可靠
快捷键跳转失灵？检查 keymap 冲突和光标位置
默认跳转匹配括号的快捷键是 ctrl-m（macOS 是 cmd-m），但这个功能高度依赖光标是否落在括号字符上 —— 它不是“找最近一对”，而是“找当前括号的另一半”。
- 光标必须停在
(、[、{、)、]或}上才有效；停在中间空白或字符串里，ctrl-m会无响应 - 如果按了没反应，去
Atom → Keymap...搜索bracket-matcher:toggle-bracket，看是否被emerald-theme或其他 UI 包劫持了绑定 - 部分语言（如 Python）因无显式括号块，
bracket-matcher对:或缩进块不做处理 —— 这不是缺陷，是机制限制
为什么改了 settings.cson 没用？路径和格式必须严格匹配
Atom 的配置优先级是：UI 设置界面 > ~/.atom/config.cson > ~/.atom/init.coffee。直接编辑文件时，CSON 格式比 JSON 更敏感，一个缩进错误或遗漏逗号就会让整段配置静默失效。
- 正确写法示例（注意缩进是两个空格，且末尾无逗号）：
"bracket-matcher": autocompleteBrackets: true closeBracketsWhenEditing: true - 不要写成 JSON 风格：
{"bracket-matcher": {...}}—— CSON 不认大括号 - 修改后必须完全重启 Atom（不是窗口重开），否则新配置不加载
- 如果用
language-protobuf这类自定义语法，需确保其grammars/protobuf.cson中的scopeName（如source.protobuf）未被bracket-matcher排除 —— 默认它只作用于常见 scope，不自动适配冷门语言
