vscode中node命令在终端能执行才算真正配好，否则所有后续操作均无效；需在系统终端验证node -v和npm -v输出版本号，改环境变量后必须彻底重启vscode，调试时应显式配置runtimeexecutable并确保package.json声明"type": "module"以支持esm。

node 命令在 VSCode 终端里能执行，才算真正配好——其余所有“一键”操作都建立在这个前提上。没这步，装插件、改配置、点调试全是空转。

验证 node 和 npm 是否真可用

很多人以为装完 Node.js 就能用，结果在 VSCode 里按 Ctrl+` 打开终端，输 node -v 却报 “command not found”。这不是 VSCode 的锅，是系统环境变量根本没生效。

• 必须在系统终端（macOS/Linux 打 Terminal，Windows 打 CMD 或 PowerShell）里运行 node -v 和 npm -v，且都有输出
• Windows 用户特别注意：安装时没勾选 “Add to PATH”，或装到了含中文/空格的路径（如 C:Program Files odejs），npm 可能静默失败
• macOS/Linux 用 nvm 的，确认 source ~/.nvm/nvm.sh 已写入 ~/.zshrc，且新开终端已加载
• 改完环境变量后，必须完全退出 VSCode 进程（macOS 在 Dock 右键选「退出」，Windows 在任务管理器里确认 Code.exe 已结束），再重新打开

别信 Code Runner 插件能“一键运行”

Code Runner 默认用 node 执行 JS 文件，但它绕过项目上下文，不读 package.json 里的 "type": "module" 或 exports 字段，一碰 ES Module 就报 Cannot use import statement outside a module。

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

• 临时测试用：在 VSCode 内置终端手动执行 node index.js，行为和真实部署一致
• 如果非要用 Code Runner，进设置搜 code-runner.executorMap，把 javascript 对应值改成：node --experimental-specifier-resolution=node $fileName
• 它不支持 process.stdin 类交互式脚本——这类代码必须在终端里手动跑

launch.json 里 runtimeExecutable 不写就容易翻车

VSCode 调试器默认按 PATH 找 node，但你终端里看到的 node 和它找到的，很可能是两个不同版本（比如 nvm 切了 v18，VSCode 却调了 v20）。

• 在项目根目录建 .vscode/launch.json，显式指定："runtimeExecutable": "/usr/local/bin/node"（macOS/Linux）或 "runtimeExecutable": "C:\nodejs\node.exe"（Windows）
• 加一行 console.log(process.execPath) 对比输出，确保和 runtimeExecutable 路径一致
• 不要依赖自动生成的配置：默认 "program": "${file}" 只适合单文件，实际项目中要改成 "program": "${workspaceFolder}/src/index.js"，否则断点会灰掉

ES Module 场景下调试失败的真实原因

写了 import express from 'express' 却提示 Cannot use import statement outside a module，不是语法错，是 Node 没认出这是模块文件。

• 必须在项目根目录 package.json 中加："type": "module"；不加就默认按 CommonJS 解析
• 文件扩展名得是 .mjs，或者明确声明 type，否则 node 无视 import
• launch.json 里不能直接指 .ts 或 .jsx 源文件——要么编译后指向 dist/index.js，要么用 runtimeExecutable: "npx" + runtimeArgs: ["ts-node", "src/index.ts"]

真正的“一键”只存在于你确认 node -v 在 VSCode 终端里能跑通之后；之前所有操作，都是在补这个基础事实。路径、环境变量、模块类型、调试器入口——四个点里任意一个没对齐，都会让你卡在“为什么就是不运行”上。