根本原因是vscode启动时未加载shell配置文件或系统path未写入node路径；需在vscode终端执行node -v验证，无输出则须彻底重启并修正~/.zshrc（macos/linux）或系统环境变量（windows），再配合terminal.integrated.env.*注入path。

VSCode 里 node -v 报 command not found，不是插件没装好，而是环境变量根本没继承进来——所有后续调试、运行、任务都卡在这一步。

node -v 在系统终端能跑，但在 VSCode 终端里失效

这是最常见也最容易误判的问题。它和 VSCode 设置、插件、launch.json 都无关，纯粹是进程启动时没加载你的 shell 初始化文件（比如 ~/.zshrc）或系统 PATH 没写入 Node.js 路径。

• macOS/Linux：从 Dock 或 Spotlight 启动 VSCode，which node 输出的路径（如 /opt/homebrew/bin/node）通常不在 VSCode 继承的 PATH 中；改完 ~/.zshrc 后必须彻底退出所有 VSCode 窗口，再从终端执行 code --no-sandbox . 启动
• Windows：安装 Node.js 时漏选 “Add to PATH”，系统变量里压根没有 C:Program Files odejs；需手动添加到「系统变量 → Path」，注意路径中不能有中文、空格，斜杠方向统一用 / 或 \
• 验证唯一标准：在 VSCode 内置终端（Ctrl + `）里直接敲 node -v；没输出就别配 launch.json，也别点 F5 —— 所有操作都是空转

launch.json 中 program 字段写死导致调试失败

VSCode 自动生成的 launch.json 默认是 "program": "${workspaceFolder}/app.js"，但你实际入口可能是 index.js、server.js，甚至当前正编辑的任意文件。

Rydberg Agent Node

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

下载

• 通用解法：把 program 改成 "${file}"，这样按 F5 就调试当前打开的 JS 文件，不用每次改配置
• 注意：这个值只对可直接运行的 JS 文件有效；如果文件含 import 但项目没设 "type": "module"，会报 Cannot use import statement outside a module
• TypeScript 项目别直接指向 .ts 文件；要确保已编译出 .js 和 .js.map，且 program 指向的是生成后的 .js 路径

code-runner 插件运行 JS 脚本出错的典型场景

code-runner 的默认命令极简：node $fileName，不处理编码、模块类型、输入流，也不读 package.json，所以容易踩坑。

• Windows 中文路径乱码：在 VSCode 设置中搜 code-runner.executorMap，把 javascript 对应值改成："node -r utf-8 $fileName"
• 报 Cannot use import statement outside a module：先确认项目根目录有 package.json 且含 "type": "module"，再把 executor 改成："node --experimental-specifier-resolution=node $fileName"
• 遇到 process.stdin 就假死：这是 code-runner 固有限制，它不支持交互式输入；换用内置终端手动运行，或改用调试模式（F5）

调试器提示 Cannot find runtime 'node' 或断点不命中

即使 node -v 在终端里跑通了，launch.json 仍可能报这个错——因为调试器走的是另一套查找逻辑，不完全依赖终端的 PATH。

• 检查 launch.json 是否显式写了 "runtimeExecutable"；如果写了但路径不对，删掉这行，让调试器走默认查找
• 用了 nvm/fnm 等版本管理工具：调试器默认不识别切换逻辑；稳妥做法是在 launch.json 中写死路径，例如："runtimeExecutable": "~/.nvm/versions/node/v18.17.0/bin/node"
• 断点不生效常因启动方式不匹配：比如用 ts-node 启动 TypeScript，但调试器配的是普通 node；应改用 node --loader ts-node/esm 模式，并在 runtimeArgs 中配置

真正卡住人的从来不是配置项本身，而是 VSCode 终端和调试器这两条路径各自读取环境变量的方式完全不同——一个靠 shell 启动时加载，一个靠 launch.json 或全局 PATH 查找。不区分清楚，就会反复在“明明能跑”和“就是调不了”之间打转。