Atom 运行 Node.js 代码依赖系统已安装且 PATH 可访问的 node（≥v14），90% 失败源于环境变量未正确配置；推荐用 platformio-ide-terminal 替代内置终端，调试应使用 Chrome DevTools + --inspect，而非 Atom 插件。
Atom 本身不运行 Node.js 代码，它只是调用你系统里已安装的 node 可执行文件——如果命令行能跑 node -v，Atom 才可能跑起来；否则所有“运行”功能都会静默失败或报 command not found。
确认系统级 Node.js 是否真正可用
这是 90% Atom 运行失败的根源，不是插件问题，而是环境没继承。
- 在终端（非 Atom 内置终端）中执行
which node和node -v，必须有输出且版本 ≥ 14（2026 年推荐 LTS 是 v20.x） - Windows 用户注意：MSI 安装时务必勾选
Add to PATH；若已安装但没勾选，重装或手动把C:\Program Files\nodejs\加进系统环境变量 - macOS 用户注意：如果用
brew install node，Zsh 配置（如~/.zshrc）改完后需source ~/.zshrc，且 Atom 必须从该终端启动（atom .），否则 GUI 启动的 Atom 读不到新 PATH - Linux 用户注意：Debian/Ubuntu 的
apt install nodejs安装的是/usr/bin/nodejs，而插件默认找node，补一个软链：sudo ln -s /usr/bin/nodejs /usr/bin/node
用 platformio-ide-terminal 替代内置终端
Atom 原生 terminal-plus 已停止维护，分屏、路径继承、编码兼容性差；platformio-ide-terminal 是目前最稳的选择。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 安装后，终端自动进入当前项目根目录（即你用
atom .打开的那个文件夹），不用再cd - 直接输入
node index.js或npm start即可运行，输出实时可见 - 按
Ctrl+Shift+T新建标签页，Ctrl+Shift+P→ 输入 “PlatformIO IDE Terminal: Split Pane” 可分屏，适合一边写代码一边看日志 - 不要装
term3或atom-terminal-panel：前者依赖过时的 Electron API，后者在 Atom v1.60+ 上常卡死
script 插件能一键运行，但别依赖它调试
script 是最轻量的“运行”方案，适合快速验证脚本逻辑，但它没有断点、变量监视、堆栈追踪能力。
- 快捷键：Mac 用
Cmd+I，Windows/Linux 用Ctrl+Shift+B，运行当前文件 - 它本质是后台起一个
node <current-file>子进程，进程退出后输出就消失，无法交互式调试 - 若脚本依赖
process.argv或需要持续监听（如 HTTP server），script会立刻退出——此时必须用终端手动运行 - 遇到
Error: Cannot find module 'xxx'，先检查当前终端是否在正确项目路径下，script不自动cd到package.json所在目录
调试必须用 Chrome DevTools，放弃 Atom 内置调试器
所有标榜 “Node.js Debugger” 的 Atom 插件（如 node-debugger、atom-nodejs）在 Node.js v14+ 上均不可靠：断点失灵、变量为空、热重载崩溃。
- 正确做法：启动时加
--inspect标志，例如node --inspect index.js - 然后打开 Chrome，访问
chrome://inspect→ 点击 “Open dedicated DevTools for Node” - 在 Sources 面板里找到你的文件，打断点、看作用域、单步执行，体验和前端调试一致
- 若用
nodemon，启动命令改为nodemon --inspect index.js，重启后 DevTools 会自动重连
真正容易被忽略的是：Atom 的语言服务（如跳转定义、类型提示）依赖 package.json 存在且项目结构规范；没有 package.json 的纯 JS 文件夹，atom-ide-javascript 根本不激活——这不是 bug，是设计使然。
