Atom源码不能直接用node运行，因其是Electron应用，依赖Electron主/渲染进程模型、预编译原生模块及特定Node ABI；直接node src/main.js会因ABI不匹配、缺少electron模块、上下文错误等报错。
Atom 源码不能“运行”，只能构建（build）后启动开发版；它本身是 Electron 应用，必须编译成可执行的桌面程序才能启动，不是 Node.js 脚本那样直接 node src/main.js 就能跑。
为什么不能直接用 node 运行 Atom 源码
Atom 是基于 Electron 的桌面应用，其源码结构依赖 Electron 主进程/渲染进程双线程模型，且大量使用原生模块（如 native-keymap、text-buffer）和预编译二进制。直接 node src/main-process/main.js 会立即报错：Error: The module '/path/to/atom/node_modules/native-keymap/build/Release/keymapping.node' was compiled against a different Node.js version——因为 Electron 自带的 Node ABI 和你系统里装的 Node 不兼容。
常见错误现象包括：
-
Cannot find module 'electron'（没走 Electron 启动流程） -
Module version mismatch（ABI 版本不匹配） - 空窗口、白屏、或控制台疯狂报
require is not defined（渲染进程未加载正确上下文）
正确构建流程：npm run build + npm run start
官方唯一支持的本地运行方式是完整构建 + 启动开发版。关键步骤不可跳过：
- 必须先执行
npm install安装全部依赖（含 Electron 二进制和原生模块） - 必须运行
npm run build：它会调用script/build，完成 TypeScript 编译、资源打包、原生模块重编译（node-gyp rebuild）、Electron 打包准备 - 必须用
npm run start启动：它等价于electron .，由 Electron 加载当前目录的package.json入口，注入正确的 Node/Electron 运行时环境 - 国内用户务必提前配置镜像：
npm config set electron_mirror https://npmmirror.com/mirrors/electron/，否则npm run build会卡在下载 Electron 二进制
调试主进程和渲染进程要分开操作
Atom 开发版启动后，两个进程完全隔离，调试方式不同：
- 主进程（Node.js 环境，管理窗口、菜单、生命周期）：执行
npm run debug，然后在 Chrome 访问chrome://inspect→ 连接 “Electron Main Process” - 渲染进程（Electron 内嵌 Chromium，运行编辑器 UI）：在 Atom 窗口中按
Ctrl+Shift+I（Win/Linux）或Cmd+Opt+I（macOS），打开 DevTools，但注意这里看到的是file://协议下的页面，断点只对 JS 文件生效，不包含原生 C++ 模块逻辑 - 别试图在渲染进程 DevTools 里
require('fs')——它没有 Node 集成（除非显式开启nodeIntegration: true，但 Atom 默认关闭）
修改代码后要不要重新 build
取决于改的是哪部分：
- 改
src/text-editor.js或static/atom.less这类纯 JS/CSS/LESS：保存后刷新窗口（Ctrl+Alt+Cmd+L）即可生效，无需重 build - 改
src/main-process/atom-window.js或任何涉及原生模块、main.js 入口、package.json 字段：必须npm run build后再npm run start，否则修改不加载 - 改
packages/下内置插件（如language-javascript）：通常只需重启 Atom 窗口（Cmd+Shift+P→ “Window: Reload”），但若插件含原生代码，仍需 build
最易被忽略的一点：Atom 的 src/ 目录下大量文件是 CoffeeScript 或 TypeScript 编写的，它们不会自动实时转译——npm run build 是唯一触发完整编译链的命令，跳过它等于在改源码，却运行着旧的 JS 输出。
