应先打开开发者工具console页，刷新atom观察“failed to activate package 'xxx'”报错；常见原因包括package.json的main路径错误、语法非法、未运行apm rebuild或activationcommands触发条件不满足。
插件显示已启用但功能不工作
这通常不是安装失败，而是插件没被 Atom 正确加载或初始化。打开开发者工具（Ctrl+Shift+I 或 Cmd+Option+I），切到 Console 标签页，刷新 Atom（Ctrl+Alt+R），观察是否有类似 Failed to activate package 'xxx' 的报错——这是最直接的线索。
常见原因包括：
-
package.json中"main"字段路径错误，或指向的 JS 文件语法非法（如用了顶层await） - 插件依赖原生模块（如
spell-check），但未运行apm rebuild适配 Atom 内置 Node 版本 - 插件的
activationCommands触发条件永远不满足（比如只在.js文件中激活，但你正在编辑.ts）
快捷键/命令找不到或被覆盖
按 Ctrl+.（Windows/Linux）或 Cmd+.（macOS）打开 Keybinding Resolver，再按下你想查的快捷键（如 Ctrl-Shift-I）。面板会显示 Atom 实际匹配到的命令和来源。
若看到多条匹配，注意 Source 列和 Selector 精度：
- 来源为
emmet、atom-beautify等插件时，优先级通常高于core -
atom-text-editor:not([mini])比atom-text-editor更具体，更容易胜出 - 如果面板完全无响应，说明按键在系统/输入法/远程桌面层已被截获，Atom 根本没收到事件
linter / autocomplete / editorconfig 类插件静默失效
这类插件依赖明确的“链式协作”，缺一环就彻底静默。例如：
-
linter-eslint必须配合linter（作者steelbrain）和linter-ui-default，三者都要启用，顺序不能错 -
autocomplete-javascript不会为Plain Text语法提供补全，哪怕文件后缀是.js—— 看右下角状态栏，必须显示JavaScript -
editorconfig插件只在你用File > Add Project Folder打开目录时才向上查找.editorconfig，单文件打开无效
安装成功但模块无法 require
控制台报 Cannot find module 'xxx' 或 Module version mismatch，大概率是本地编译产物损坏或 Node 版本错位。
关键动作：
- 先关闭所有 Atom 窗口（包括后台进程）
- 运行
apm rebuild—— 它强制用 Atom 自带 Node 重编译所有包；npm rebuild无效，它调的是系统 Node - 若
apm rebuild报 zlib 错误，说明缓存已坏：先apm clean，再重试 - Mac 用户注意：
atom --safe从终端启动和从 Dock 启动，Node 环境变量可能不同，导致同一插件一种方式崩溃、另一种正常
apm rebuild 不是可选项）。
