应先运行atom --safe进入安全模式确认是否为插件导致；若正常，则用apm list --installed --packages记录已装插件，再按启用时间倒序禁用最新插件逐一排查。
怎么快速定位哪个插件在报错或崩溃
Atom 启动失败、卡死、控制台疯狂刷红字，但又不确定是哪个插件惹的祸？直接进安全模式最省事：atom --safe。这个命令会跳过所有第三方包，只加载 Atom 自带功能。如果此时一切正常，就基本锁定问题是出在某个社区插件上。
接下来别急着一个个开关——先执行 apm list --installed --packages，把当前装了啥记下来；再用 atom --safe 启动后，进 Settings → Packages，按启用时间倒序排列（右上角排序按钮），优先禁用最近更新或新装的几个。禁用一个就重启 Atom 测试一次，比盲目排查快得多。
- 崩溃前刚执行过
apm update？重点盯linter-eslint、vim-mode-plus、prettier-atom这类高频更新插件 - 控制台报
Cannot find module 'xxx'或Module version mismatch？大概率是本地模块编译失败，不是插件本身逻辑错 - Mac 用户特别注意：从 Dock 点开 Atom 和从终端
atom命令启动，Node 环境变量可能不同，导致某些插件在一种方式下崩溃，在另一种下正常
incompatible-packages 工具为什么没反应
incompatible-packages 是 Atom 内置的冲突检测器，但它只管“编译兼容性”，不查逻辑冲突或 API 调用错误。如果你没看到状态栏右下角那个带数字的警告图标，常见原因有三个：
- 插件根本没被 Atom 加载——比如
package.json里"main"字段路径写错，或activationCommands触发条件永远不满足 - 插件用了 Electron/Node.js 不支持的语法（如顶层 await、import.meta），Atom 在 require 阶段就抛错，根本走不到兼容性检查环节
- 你手动删过
~/.atom/packages/xxx/node_modules但没运行apm rebuild，导致incompatible-packages扫描时发现模块缺失，直接跳过该包
验证方法：打开开发者工具（Window: Toggle Dev Tools），切到 Console 标签页，刷新 Atom，看有没有 Failed to activate package 'xxx' 类报错——这才是真凶线索。
linter 报错不显示，但 terminal 里 eslint 能跑通
这不是插件坏了，是数据链断在中间。Linter 的工作流是：linter-eslint 调用 ESLint → 生成 Diagnostic 对象 → 交给 linter-ui-default 渲染。任意一环掉链子，UI 就空白。
- 检查
linter-ui-default是否启用：Settings → Packages → 搜linter-ui-default→ 确认开关是蓝色 “Enabled” - 确认
linter-eslint设置页里的ESLint Path指向项目内路径，比如./node_modules/.bin/eslint，而不是全局eslint（尤其当项目用 pnpm 或 yarn v4 时，全局路径大概率不对） - 打开开发者工具 → Console，输入
atom.packages.getActivePackage('linter-eslint').mainModule，看返回对象里provideLinter是否为函数——如果不是，说明插件根本没成功激活 - 如果用 TypeScript，确保
.eslintrc.cjs里parserOptions.project指向正确的tsconfig.json，否则 ESLint 会静默跳过整个文件
插件冲突修复后为什么还会复发
因为 Atom 不会自动帮你锁版本。今天 apm rebuild 修好了，明天 apm update 又可能拉下一个不兼容的新版。真正防复发的关键动作只有两个：
- 把常用插件的版本钉死：编辑
~/.atom/packages/package-name/package.json，把"version"改成固定值（如"2.5.1"），并删掉"dist"字段（避免 apm 自动覆盖） - 禁用自动更新：在
~/.atom/config.cson里加一行'core': {'automaticallyUpdatePackages': false}，更新前先手动apm outdated看清单，再逐个评估
最常被忽略的一点：Atom 的 incompatible-packages 只扫描已加载包，而有些插件（比如 language-babel）会在首次打开 .js 文件时才动态激活——这意味着你关掉所有 JS 文件再重启 Atom，它就压根不会出现在冲突报告里。
