插件“已启用”但语法高亮不生效，主因是atom内置node（v12.x/v14.x）与原生模块不兼容，需apm rebuild重编译；或语法作用域未匹配（如右下角显示plain text）、grammar与theme任一缺失/冲突。
插件显示“已启用”但语法高亮完全不生效
这不是安装失败，而是 Atom 内置 Node 环境与插件原生模块不兼容。Atom 自带独立 Node（当前主流为 v12.x 或 v14.x），不走系统 Node，process.versions.node 在 DevTools（Ctrl+Shift+I）中可确认。若插件含原生模块（如 spell-check、term3），必须用 apm rebuild 重编译——否则模块加载失败，语法高亮静默失效。
- 运行
apm rebuild后重启 Atom，不是重载窗口 - 若报错 “No version of node found”，说明 Atom 内置 Node 损坏，需重装 Atom 官方版
- 某些插件（如
language-babel）不依赖原生模块，但高亮失效常因语法作用域未匹配：检查右下角状态栏是否为source.js而非text.plain或source.js.jsx
安装后右下角始终显示 “Plain Text”
Atom 不会自动将文件绑定到语法包，尤其对无后缀、自定义扩展名或未保存文件。语法识别失败，高亮引擎根本不会启动。
- 未保存文件一律视为
text.plain，必须先保存（如存为nginx.conf） - 手动指定语法：按 Ctrl+Shift+L，从列表选正确 grammar（如
Nginx、Vue Component） - 检查
config.cson是否存在全局覆盖，例如"*.conf": "source.ini"会强制所有 .conf 当 INI 处理，直接屏蔽language-nginx - Vue 单文件组件需
language-vue插件，且右下角必须显示source.vue；若显示text.html.vue，说明语法包未接管
高亮颜色淡、括号不配对、关键词不着色
语法高亮由两层叠加：grammar 定义 token 类型（如 keyword.control），theme 控制渲染样式。两者任一缺失或冲突，都会导致视觉异常。
- 括号高亮失效？确认
bracket-matcher已启用，并检查.bracket-matcher .region在styles.less中的background-color是否被主题覆盖（加!important和足够 alpha 值） - 关键词（如
const、export）不着色？可能是 grammar scope 错误：执行Editor: Log Cursor Scope，看光标处 token 是否落在keyword.control下；若为invalid.illegal，说明语法包未识别该语法（如 ES2020 新特性需language-babel@3.0.0+） - 深色主题下高亮不可见？别调 theme 设置，直接在
styles.less中覆盖.highlight-selected或.syntax--keyword类
插件安装失败或启用后立即报错
官方 apm 服务器已于 2022 年底关闭，且部分插件（如 pigments）在 Atom 1.59+ 中因 API 移除彻底失效——这不是网络或权限问题，是硬性兼容断层。
-
apm install报 404 或 “No versions available”：改用手动安装。下载 GitHub 上最后兼容版本 ZIP，解压后执行apm link --dev /path/to/plugin -
Cannot read property 'onDidChange' of undefined：这是 Atom 1.59+ 移除了TextEditor::onDidChange接口，插件无法启动。唯一办法是降级到 Atom 1.58 或改用其他编辑器 - 依赖 Node 版本不匹配？运行
apm rebuild；仍失败则说明插件已停止维护，需寻找替代方案（如用atom-ide-vue替代老旧language-vue）
