先确认插件是否加载：打开开发者工具→Console→刷新Atom，查看Failed to activate package或Cannot find module类报错；若有，说明require阶段失败，常见因node_modules缺失、版本不匹配或package.json中main路径错误。
插件服务启动失败，先确认是不是插件本身没加载
Atom 的插件服务（比如 linter、atom-ide-base、language-server-xyz）启动失败，往往不是“报错后退出”，而是根本没注册进服务系统——表现为命令面板搜不到对应命令、状态栏无图标、快捷键无响应。
打开开发者工具（Ctrl+Shift+I 或 Cmd+Option+I），切到 Console 标签页，刷新 Atom（Window: Reload），重点看有没有类似这样的输出：
Failed to activate package 'linter-eslint'<br>Cannot find module 'atom-languageclient'
如果有，说明该插件在 require 阶段就中断了，后续所有服务都不会启动。常见原因包括：
-
node_modules缺失或损坏：运行apm rebuild（确保 Atom 完全退出后再执行） - 依赖包版本不匹配：比如
atom-languageclient要求 Atom v1.65+，但你用的是 v1.58，就会静默失败 -
package.json里main字段路径错误，或activationCommands触发条件永远不满足（如只监听atom-text-editor[data-grammar~="source.js"]，但你打开的是.ts文件）
linter / ide 插件服务不启动，检查三件套是否齐备且启用
Atom 1.24+ 后，linter 系列和 atom-ide-* 系列插件采用分层架构，缺一不可。例如 linter-eslint 无法独立工作，必须依赖：
-
linter（作者steelbrain）——调度中枢，必须启用 -
linter-ui-default——错误渲染器，必须安装且启用（它不随linter自动装） -
linter-eslint或atom-ide-eslint——具体语言 provider，需正确配置 ESLint 路径
任意一个被禁用、未安装，或安装后没执行 Window: Reload，都会导致服务“看似存在，实则瘫痪”。特别注意：linter-ui-default 在 Settings → Packages 里搜不到？说明它根本没装，得手动 apm install linter-ui-default。
启动时报 Module version mismatch 或 Cannot find module 'xxx'
这类错误几乎都指向原生模块编译失败，不是代码逻辑问题，而是构建环境断链。Atom 内置 Node.js 和 Electron 头文件路径是固定的，npm install 无效，必须用 apm 工具链：
- 先关掉所有 Atom 进程（包括后台的
atom --background） - 运行
apm clean清空~/.atom/.apm和~/.atom/packages/*/node_modules - 再运行
apm rebuild—— 它会重新调用node-gyp，使用 Atom 自带的 Node 版本和electron-mksnapshot头文件 - 如果
apm rebuild报 zlib 错或gyp ERR!，说明缓存已脏，重复前两步
Mac 用户额外注意：从 Dock 启动 Atom 和从终端运行 atom 命令，加载的 Node 环境变量可能不同，导致同一插件在一种方式下崩溃、另一种下正常。统一用终端启动可排除干扰。
服务启动后立即崩溃，检查是否用了废弃协议或 API
某些插件仍硬编码旧版调试/通信协议，Atom 升级后直接不兼容。典型表现是控制台刷屏式报错，但编辑器界面还能操作：
-
node-debugger插件报connection attempt 1 to node process on 127.0.0.1:5858 failed：Node.js v8+ 已移除--debug，必须换用atom-ide-debugger-node或改用--inspect -
atom-ide-*系列插件在 Atom v1.70+ 上报getProvider is not a function：说明插件未适配新版atom-ide-base的服务接口，需等作者更新或降级插件 -
autocomplete-plus相关插件报textEditor.onDidStopChanging is not a function：Atom 已弃用该事件，新版本改用onDidStopChanging（无textEditor.前缀），老插件需升级
这类问题没有热修复，只能停用、替换或回退插件版本。别指望改几行源码就能绕过——API 层已断裂，补丁只是掩盖症状。
