插件未加载的真实状态是命令面板搜不到、状态栏无图标、快捷键无响应；Failed to activate package报错说明require阶段已中断，常见原因包括main路径错误、依赖缺失、activationCommands条件不满足、Electron不支持语法及linter/ide“三件套”缺一不可。
插件根本没加载进服务系统，不是报错后失败，而是压根没注册——命令面板搜不到、状态栏无图标、快捷键无响应，这才是 Atom 插件“无法启动”的真实状态。
Failed to activate package 报错说明 require 阶段就中断了
打开开发者工具（Ctrl+Shift+I），切到 Console 标签页，刷新 Atom（Window: Reload），重点找形如：
Failed to activate package 'linter-eslint'<br>Cannot find module 'atom-languageclient'
这类错误意味着插件在 require 时直接抛出异常，后续所有逻辑（包括服务注册）都不会执行。常见原因有：
-
package.json中"main"字段路径错误，比如写成./lib/main.js，但实际文件在./src/main.js - 依赖缺失或版本不匹配：例如
atom-languageclient要求 Atom>=1.65.0，而你用的是 v1.58，就会静默失败 - activationCommands 触发条件永远不满足，比如只监听
atom-text-editor[data-grammar~="source.js"]，但你打开的是.ts文件，插件连初始化机会都没有 - 用了 Electron 不支持的语法（如顶层
await、import.meta），Node 在require阶段直接报错退出
linter / ide 类插件“三件套”缺一不可
Atom 1.24+ 后，linter 系列和 atom-ide-* 插件采用分层架构，任意一层缺失都会导致服务瘫痪，且不报错、只沉默。
以 linter-eslint 为例，必须同时满足：
-
linter（作者steelbrain）已安装且启用 —— 它是调度中枢，不是可选组件 -
linter-ui-default已安装且启用 —— 它不随linter自动安装，必须手动apm install linter-ui-default -
linter-eslint或atom-ide-eslint已安装，并在设置中正确配置 ESLint 路径（如./node_modules/.bin/eslint）
特别注意：linter-ui-default 在 Settings → Packages 里搜不到？说明它根本没装，不是禁用了——这是最常被忽略的一环。
Module version mismatch 错误本质是原生模块编译失败
这类错误（如 Module version mismatch. Expected 102, got 93）不是代码逻辑问题，而是插件里的 .node 文件用旧版 Node 编译过，新 Atom 内置 Node（v20）无法加载。
修复必须走 Atom 专用工具链：
- 先彻底关闭所有 Atom 进程（包括后台的
atom --background） - 运行
apm clean清空~/.atom/.apm和各插件下的node_modules - 再运行
apm rebuild—— 它会调用node-gyp，使用 Atom 自带的 Node 版本和 Electron 头文件重新编译 - 别用
npm rebuild，它调的是系统 Node，对 Atom 完全无效
如果 apm rebuild 报 zlib 或 EACCES，说明缓存已损坏，必须先 apm clean 再重来。
incompatible-packages 工具几乎查不出真问题
Atom 内置的 incompatible-packages 只检查编译兼容性（比如 engines.atom 字段是否满足），对以下情况完全无感：
- 插件根本没被加载：比如
package.json中"main"路径写错，或activationCommands条件永不触发 - API 调用失败：如调用已废弃的
atom.workspace.getActiveTextEditor()返回null，后续.onDidStopChanging就崩 - 模块路径错误：
Cannot find module 'season'这类报错，incompatible-packages压根不扫描
真正有用的线索永远在开发者工具的 Console 里，而不是右下角那个数字图标。只要看到 Failed to activate package，就别再查兼容性列表了——那是假象。
