atom --safe 是第一诊断动作，不是可选项；它跳过所有第三方插件和用户配置，仅加载核心功能，若此时正常则问题必在 ~/.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（路径按实际调整）。
常见误操作：
- 在安全模式下试图安装或调试插件——它只是隔离环境，不是工作环境
- 看到安全模式正常，就认为“插件没问题”，其实只是没被加载而已
- 没关掉所有 Atom 窗口（包括后台进程）就重启测试，旧 runtime 缓存仍在干扰
apm list + 倒序禁用，比瞎猜快十倍
确认是插件导致后，别一个个开关。先运行 apm list --installed --packages 记下当前已装插件列表，再进 atom --safe → Settings → Packages，点右上角排序按钮，选 “Last Updated” 倒序排列。
优先禁用最近更新或新装的几个，尤其是这些高频出事的包：
-
linter-eslint（常因 ESLint 版本升级或.eslintrc配置错崩溃） -
vim-mode-plus（键盘事件监听冲突，易引发Cannot read property 'getSuggestions' of undefined） -
prettier-atom（格式化时调用 Node 子进程失败，报spawn ENOENT）
每禁用一个，完整退出 Atom 再重启测试。Mac 用户注意：从 Dock 点开 Atom 和从终端运行 atom，Node 环境变量可能不同，同一插件在两种方式下表现可能不一致。
控制台红字里找真凶，别信 incompatible-packages
Atom 内置的 incompatible-packages 工具只检查编译兼容性，对逻辑错误、API 调用失败、模块路径写错完全无感。它不报错 ≠ 插件没问题。
真正有用的线索藏在开发者工具里：按 Ctrl+Shift+I（macOS Cmd+Option+I）打开 DevTools → Console 标签页 → 刷新 Atom → 找形如 Failed to activate package 'xxx' 或 Cannot find module 'yyy' 的报错。
这类错误常见原因：
-
package.json里"main"字段路径错误，或activationCommands触发条件永远不满足（比如设成"core:save"却从没保存过） - 用了 Electron 不支持的语法（如顶层
await、import.meta），require 阶段直接抛错，根本走不到兼容性检查 - 手动删过
~/.atom/packages/xxx/node_modules但没运行apm rebuild，扫描时发现缺失模块，直接跳过该包
script 插件报 Command not found，本质是路径没对齐
script 插件报 Command not found: python 或 createfile : the system cannot find the file specified，不是 Python 没装，而是插件找不到解释器或脚本路径解析失败。
必须做三件事：
- 终端执行
which python3（macOS/Linux）或where python（Windows），确认有输出；没有就重装 Python 并勾选 “Add Python to PATH” - 进
atom://config→ 找到script包 → 把Command字段填成你终端里能跑通的绝对路径，例如C:\Python39\python.exe或/usr/local/bin/python3，别留空、别写py - 在
Args字段显式包裹文件路径：['-u', '"'+filepath+'"']（注意双引号保留），避免空格或中文路径被 shell 错误截断
如果用了 pythonw.exe（Windows GUI 版本），它会静默吃掉所有 stderr，导致 1/0 这种错误完全不显示——换回 python.exe。
