插件“已安装”“已启用”但功能失效，根本原因是atom未真正加载它，核心在于环境链断裂：atom --safe可快速定位是否为配置或插件冲突所致；含原生模块的插件必须运行apm rebuild强制用atom内置node重编译；功能触发还依赖精确上下文（如文件已保存、路径无中文、语言模式正确等），控制台报错才是真实线索。
插件“已安装”“已启用”，但快捷键没反应、命令搜不到、面板打不开——这不是插件失效，而是 Atom 没真正加载它。核心原因几乎全是环境链断裂，不是重装能解决的。
为什么 atom --safe 能快速定位问题
Atom 启动时会按固定顺序加载：内置核心 → 用户配置（config.cson）→ 第三方包（~/.atom/packages/）。任何一步出错都会静默跳过后续包，导致插件“存在但不可用”。
atom --safe 强制跳过用户配置和所有第三方包，只跑内置核心。如果这时功能正常，就说明问题一定出在 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 - 安全模式下不要装插件——它只是诊断工具，不是工作环境
apm rebuild 是什么，什么时候必须执行
Atom 自带独立 Node.js（当前主流为 v12.x/v14.x），不走系统 Node。插件若含原生模块（如 spell-check、term3、platformio-atom-ide-terminal），就必须用 Atom 内置 Node 重新编译。否则模块加载失败，插件注册阶段就被跳过。
典型表现：插件显示“Enabled”，但快捷键无响应、状态栏图标不出现、开发者工具 Console 里有 Cannot find module 'xxx' 或 Module version mismatch 报错。
- 必须先完全关闭所有 Atom 窗口（包括后台进程）
- 运行
apm rebuild，不是npm rebuild（后者调系统 Node，完全无效） - 若报 zlib 错误，说明缓存损坏，先
apm clean再apm rebuild
插件功能触发失败的隐藏条件
很多插件不是“装完即用”，而是依赖精确的运行时上下文。缺一个条件，整个功能链就断掉，且通常不报错。
-
markdown-preview-plus：文件必须已保存、扩展名是小写.md、右下角状态栏显示Markdown（点它手动切换）、路径不能含中文或空格 -
linter-eslint：必须先装linter（作者 steelbrain），再装linter-eslint和linter-ui-default；三者缺一或任一被禁用，都会静默失效 -
atom-beautify：快捷键无反应，大概率是被其他插件占用；保存自动格式化不生效，是因为Beautify On Save默认关闭，且只对识别为对应语言的文件生效
控制台报错却找不到源头？直接看 DevTools
Atom 的 incompatible-packages 工具只检查编译兼容性，不捕获运行时报错。真正可靠的线索在开发者工具里。
打开 Window: Toggle Dev Tools（Ctrl+Shift+I），切到 Console 标签页，刷新 Atom（Ctrl+Alt+R），重点盯这些信息：
-
Failed to activate package 'xxx'—— 插件根本没挂载成功 -
Cannot find module 'yyy'—— 依赖缺失或路径错误 -
ActivationCommands not registered——package.json里activationCommands配置为空或条件永远不满足
这些才是真实启动失败日志。别被设置页里“Enabled”两个字骗了——它只代表开关开了，不代表代码真跑起来了。
