能跑 node -v 和 npm -v，且 vscode 内置终端里也能执行成功，才算 node 环境真正就位——验证必须在彻底退出 vscode 后，于系统原生终端确认 which node 或 where node 路径正确，再重启 vscode 并在内置终端复测，否则调试器因读取旧 path 快照而失败。

能跑 node -v 和 npm -v，且 VSCode 内置终端里也能执行成功，才算 Node 环境真正就位——其余所有配置都建立在这个前提上。

验证 node 和 npm 是否真被系统识别

很多人卡在“明明装了却调试不了”，根源是环境变量没生效。关键不是“安装过”，而是“当前所有终端（包括 VSCode 启动时加载的）都能调用到”。

• 关闭所有 VSCode 窗口，**彻底退出进程**（macOS 右键 Dock 图标选「退出」；Windows 在任务管理器中确认 Code.exe 已结束）
• 打开系统原生终端（不是 VSCode 里的 Terminal），运行：which node（macOS/Linux）或 where node（Windows），确认路径指向你安装的 Node.js（如 /usr/local/bin/node 或 C:\Program Files\nodejs\node.exe）
• 再启动 VSCode，按 Ctrl+` 打开内置终端，立刻执行 node -v 和 npm -v —— 这次的结果才代表 VSCode 能真正调用
• Windows 用户若装在含中文或空格路径（如 D:\我的软件\nodejs），npm 可能静默失败，必须重装到纯英文无空格路径

launch.json 中 program 字段怎么填才不踩坑

program 指定的是要启动的 JS 入口文件，但默认生成的 "program": "${file}" 只适合单文件调试，实际项目结构稍一复杂就失效。

Rydberg Agent Node

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

下载

• 项目有明确入口（如 src/app.js 或 index.js），直接写死路径："program": "${workspaceFolder}/src/app.js"
• 想用 npm start 启动？别改 program 为 "npm"，而是改成："program": "${workspaceFolder}/node_modules/.bin/npm"（Linux/macOS）或 "program": "${workspaceFolder}/node_modules/.bin/npm.cmd"（Windows），并加 "args": ["start"] 和 "console": "integratedTerminal"
• 用 nodemon？不能用 launch 模式直接跑，必须切到 attach 模式：先命令行执行 nodemon --inspect-brk index.js，再在 launch.json 中配 "request": "attach"、"port": 9229

调试时提示 Cannot find runtime 'node' 怎么办

这不是 VSCode 设置问题，而是底层根本找不到 node 可执行文件——和 launch.json 内容无关，只和环境变量有关。

• VSCode 启动时读取的是它启动那一刻的系统 PATH，不是你后来在终端里 export 的临时变量
• macOS/Linux 用 nvm 的，确保 source ~/.nvm/nvm.sh 已写入 ~/.zshrc（或 ~/.bash_profile），且新终端已加载
• Windows 用户检查系统环境变量 Path 是否包含 Node.js 安装目录（如 C:\Program Files\nodejs），修改后必须重启 VSCode 才生效
• 不要依赖 VSCode 内置终端里手动 export PATH=...，那只是当前会话有效，对调试器无效

真正容易被忽略的是：VSCode 调试器启动时，不会重新加载 shell 配置，它只认启动那一刻的环境变量快照。哪怕你在终端里 node -v 成功了，VSCode 也可能还在用旧 PATH。这点不厘清，所有后续配置都是徒劳。