atom 的本地调试能力已基本失效：前端仅支持 chrome devtools，python 仅支持 debugpy 手动 attach，其他语言几乎无法调试。根本原因是 electron 30+ 不再导出 dap/cdp 所需接口，导致主流调试插件失效且无法修复。
Atom 本身不提供本地调试能力，2026 年主流调试插件（atom-debug-ui、nuclide、ide-cpp 等）已停止维护或与 Electron 30+ 不兼容，直接配“F5 启动调试”基本无效。
为什么按 F5 或点 Debug 按钮没反应
这不是配置漏了，而是底层协议已断裂：Atom 的调试插件依赖 DAP（Debug Adapter Protocol）或旧版 CDP，但当前 Electron 版本不再导出所需接口。典型表现是开发者工具（Ctrl+Shift+I）控制台持续报错：Cannot read property 'onDidDestroy' of undefined 或 spawn ENOENT（找不到调试器二进制）。
- 别试重装插件或升级 Node.js——问题在 Electron 层，不是插件版本问题
- 右下角语言状态显示
Plain Text时，任何调试功能都不会触发 - 即使插件列表里显示“已启用”，只要控制台有红色 DAP 相关错误，就说明链路已断
Python 唯一可行的 attach 调试路径
只有 Python 场景还保留最低限度的可调试性，前提是严格满足三个硬条件：用 debugpy、手动启动监听、且 Atom 必须 attach 到已运行进程。
- 先在终端执行：
python -m debugpy --listen 5678 --wait-for-client -m myapp.main（myapp.main是模块名，不能写./main.py） - Atom 中打开项目根目录（不是单个文件），确保
PYTHONPATH包含该模块路径 - 在 Atom 的调试面板里选
Python类型（"type": "python"大小写敏感），填 host/port，然后点 Attach - 如果报
ModuleNotFoundError，说明 Atom 启动时没继承 shell 的PYTHONPATH，需在init.coffee里手动注入
JS/TS 只能靠 Chrome DevTools
Atom 自身基于 Electron，所有前端 JS/TS 逻辑（包括插件代码、UI 渲染）都可通过内置 DevTools 调试，这是目前唯一稳定路径。
- 按
Ctrl+Shift+I（Windows/Linux）或Cmd+Opt+I（Mac）打开 DevTools - 切换到
Sources面板 → 展开file://或webpack://→ 找到你的插件 JS 文件设断点 - 主进程调试需额外指定
"program": "${workspaceFolder}/src/main-process/main.js"，但这仅适用于你正在开发 Atom 插件本身 - 别指望“F5 启动网页并调试”——Atom 没有内置浏览器环境，
livereload类插件早已失效
真正卡住人的从来不是“怎么配”，而是没意识到 Atom 的调试链路在 2026 年已经退化为三段互不连通的孤岛：前端靠 DevTools、Python 靠手动 debugpy attach、其他语言几乎只能靠 print() 或切到 VS Code / CLion。
