先执行atom --safe验证是否为插件导致：若正常则问题必在~/.atom/packages/或~/.atom/config.cson中；再查Console报错、运行apm rebuild修复模块，确保linter三件套齐备并启用。
Atom插件不工作，90%不是代码问题，而是加载链断裂或环境错配——先别改配置，直接用 atom --safe 隔离验证。
怎么快速判断是不是插件导致的故障
执行 atom --safe 是第一动作，不是可选项。它跳过所有第三方插件和用户配置，只加载 Atom 核心功能。如果这时能正常打开、语法高亮有、快捷键响应，那问题 100% 出在 ~/.atom/packages/ 或 ~/.atom/config.cson 里。
- Windows 用户必须从 CMD/PowerShell 运行该命令，双击快捷方式无效
- macOS/Linux 若提示
command not found: atom，需先建软链：sudo ln -s /Applications/Atom.app/Contents/Resources/app/atom.sh /usr/local/bin/atom - 常见误操作：在安全模式下试图安装插件，或看到安全模式正常就认为“插件没问题”——它只是没被加载而已
- 每次测试前务必关掉所有 Atom 窗口（包括后台进程），否则旧 runtime 缓存仍在干扰
控制台报 Failed to activate package 'xxx' 怎么修
这类错误说明插件在 require 阶段就中断了，后续服务根本不会注册。典型表现是命令面板搜不到对应命令、状态栏无图标、快捷键无响应。
- 检查
package.json中main字段路径是否正确，或activationCommands触发条件永远不满足（比如设成"core:save"却从没保存过） - 运行
apm rebuild（确保 Atom 完全退出后再执行）——它会用当前 Atom 内置 Node 和 Electron 头文件重新编译所有原生模块 - 若报
Module version mismatch或Cannot find module 'xxx'，大概率是node_modules损坏或版本不匹配，先apm clean再apm rebuild - 别用
npm rebuild，它调的是系统 Node，对 Atom 完全无效
为什么装了 linter-eslint 却完全没反应
Atom 1.24+ 后，linter 系列采用分层架构，linter-eslint 无法独立工作，必须三者齐备且启用：
-
linter（作者 steelbrain）——调度中枢，必须启用 -
linter-ui-default——错误渲染器，必须手动安装（apm install linter-ui-default）且启用 -
linter-eslint或atom-ide-eslint——语言 provider，需正确配置 ESLint 路径 - 任意一个被禁用、未安装，或安装后没执行
Window: Reload，都会导致服务“看似存在，实则瘫痪” - 特别注意：
linter-ui-default在 Settings → Packages 里搜不到？说明它根本没装，得手动装
插件更新卡在 Fetching 或超时怎么办
本质是默认 registry https://atom.io/api 被本地网络策略、DNS 污染或防火墙阻断，不是网速问题。
- 换源是最快见效的方式：
apm config set registry https://npmmirror.com/mirrors/atom - 配完必须验证：
apm config get registry输出必须是你刚设的地址，否则静默失败 - 别信“重试几次就好”，超时就是连接被阻断，不是临时抖动
- 更新后仍不生效？必须完全退出 Atom（macOS 注意 Activity Monitor 中结束所有 Atom 进程），再重开——这是最常被忽略的操作盲点
复杂点在于：很多插件已停止向 atom.io 同步新版本，apm install xxx 拉下来的可能是停更分支；真正兼容新版 Atom 的 release 往往只在 GitHub Releases 页面，需要手动指定 URL 安装。另外，Mac 用户要注意，从 Dock 启动和终端 atom 命令启动，环境变量可能不同，建议统一用终端方式复现问题。
