插件“已启用”但功能不生效，是因atom内置node（v12.x/v14.x）无法加载模块，需用apm rebuild强制重编译；若报zlib错误，须先apm clean再重试；安全模式atom --safe可快速定位插件或配置问题。
插件显示“已启用”但功能不生效
这不是安装失败，而是 Atom 内置 Node 环境无法加载模块。Atom 自带独立 Node（当前主流为 v12.x 或 v14.x），不走系统 Node，所以 npm rebuild 完全无效。
- 打开 Atom DevTools（
Ctrl+Shift+I），在 Console 中输入process.versions.node，确认当前运行的 Node 版本 - 若插件含原生模块（如
spell-check、term3），必须执行apm rebuild—— 它会强制用 Atom 内置 Node 重新编译所有包 - 执行前务必关闭所有 Atom 窗口（包括后台进程），否则重建会跳过正在使用的包
- 若
apm rebuild报zlib错误，说明缓存已损坏，先运行apm clean再重试
Atom 启动卡死、控制台狂刷红字
直接进安全模式是最有效的隔离手段，不是试探，是诊断刚需。
- 终端运行
atom --safe：跳过所有第三方包，只加载 Atom 核心。如果此时正常，问题必在~/.atom/packages/或~/.atom/config.cson - 不要手动一个个开关插件——先执行
apm list --installed --packages记录当前安装列表 - 在
atom --safe下进入 Settings → Packages，按“启用时间”倒序排列，优先禁用最近更新或新装的几个（如linter-eslint、vim-mode-plus） - 禁用一个就重启 Atom 测试一次；Mac 用户注意：从 Dock 启动和终端
atom命令可能加载不同 Node 环境，崩溃表现可能不一致
离线环境插件装上了却没反应
90% 的离线失败不是路径错，而是插件目录里压根没有 node_modules —— Atom 启动时不会自动装依赖，只加载已构建完成的包。
- 必须在与目标机**完全一致 Atom 版本**（如 v1.69.0）的联网机器上，执行
apm install --production linter-gcc -
--production不可省：跳过devDependencies，避免因离线机缺 Python / 编译工具链而失败 - 执行后检查
~/.atom/packages/linter-gcc/node_modules是否存在，且包含gcc、atom-linter等子目录 - 别用
npm install替代：它不校验engines.atom字段，也不调用 Atom 专属的node-gyp路径，原生模块基本无法加载
控制台报 Cannot find module 'xxx' 或 Module version mismatch
这类错误几乎都指向模块编译失败，而不是插件代码本身有 bug。
- 常见诱因：插件用了 Electron/Node 不支持的语法（如顶层
await、import.meta），Atom 在require阶段就抛错，根本走不到兼容性检查环节 -
incompatible-packages工具不报错？可能因为插件package.json中"main"字段路径写错，或activationCommands触发条件永远不满足，导致包根本没被加载 - 验证真凶：打开 DevTools → Console → 刷新 Atom，重点找
Failed to activate package 'xxx'这类报错，这才是准确线索 - 手动删过
~/.atom/packages/xxx/node_modules却没跑apm rebuild？incompatible-packages 会直接跳过该包，不扫描也不提示
package.json 的 "main" 指向了不存在的文件，或者 activationCommands 设置成一个永远不会触发的事件，导致整个包在启动阶段就被跳过——连报错都不会有。
