atom --safe 是第一道诊断线，它跳过所有第三方包和用户主题，只加载 atom 自带核心；若此时正常，则问题必在 ~/.atom/packages/ 或 ~/.atom/config.cson 中。
atom --safe 是第一道诊断线
Atom 启动后立刻崩溃、白屏、卡死在启动画面，或控制台疯狂刷红字但看不出具体插件名——别猜，直接用 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（路径按实际调整）。
禁用插件要按启用时间倒序排查
安全模式下别急着干活，它是诊断工具。先执行 apm list --installed --packages 记下当前装了哪些包，再进 Settings → Packages，点右上角排序按钮，选 “Last Enabled” 倒序排列。最近更新或新装的插件最可疑，优先禁用它们。
- 刚执行过
apm update？重点盯linter-eslint、vim-mode-plus、prettier-atom这类高频更新包 - 禁用一个就完全退出 Atom（包括后台进程），再重启测试，别省这一步
- Mac 用户注意：从 Dock 点开 Atom 和从终端运行
atom，Node 环境变量可能不同，同一插件在两种方式下表现不一致
incompatible-packages 不报错 ≠ 没冲突
incompatible-packages 是 Atom 内置的兼容性扫描器，但它只检查编译层兼容性（比如 Electron 版本匹配），不查逻辑冲突或 API 调用错误。状态栏没看到带数字的警告图标，常见原因有三个：
- 插件根本没被加载：比如
package.json里"main"字段路径写错，或activationCommands触发条件永远不满足 - 插件用了 Node.js 不支持的语法（如顶层
await、import.meta），Atom 在require阶段就抛错，根本走不到兼容性检查环节 - 手动删过
~/.atom/packages/xxx/node_modules但没运行apm rebuild，导致扫描时模块缺失，直接跳过该包
真凶线索藏在开发者工具里：按 Ctrl+Shift+I 打开 DevTools → Console 标签页 → 刷新 Atom，看有没有 Failed to activate package 'xxx' 类报错。
崩溃前刚装/更新过插件？先 clean + rebuild
装完插件不加载、快捷键失效、语法高亮不生效，不是安装失败，而是 Atom 内置 Node（v12.x/v14.x）和插件原生模块不匹配。典型症状是 process.versions.node 显示版本，但插件行为异常。
必须执行：
- 完全退出所有 Atom 窗口（包括后台进程）
-
apm clean（清空~/.atom/.apm和~/.atom/packages缓存） -
apm rebuild（强制用当前 Atom 内置 Node 重新编译所有包）
别用 npm rebuild —— 它调的是系统 Node，对 Atom 完全无效。若 apm rebuild 报 zlib: unexpected end，说明缓存已损坏，先 apm clean 再重来。
真正难处理的不是“哪个插件崩了”，而是某些插件在崩溃前根本不报错，只让 Atom 进程静默退出。这时候必须靠 atom --safe + 时间倒序禁用 + apm clean && apm rebuild 三板斧组合，漏掉任意一环都可能反复踩坑。
