vscode本身不提供node.js运行环境,必须先在系统级安装node.js并确保path正确配置;验证需在cmd/powershell中执行node -v和npm -v输出版本号,若失败则重装时务必勾选“add to path”或手动添加路径,之后彻底重启vscode。

VSCode 本身不带 Node.js,所谓“连接本地 Node 环境”,本质就是让 VSCode 的终端和调试器能调用到你系统里装好的 node 命令——只要这一步通了,后续运行、调试、npm 都自然可用。
确认 node 和 npm 在系统终端能执行
别跳过这步。很多人卡在 VSCode 里报错,其实根本没在系统级验证过安装是否真成功。
- 打开 Windows 的 CMD 或 PowerShell(不是 VSCode 终端),输入
node -v和npm -v - 必须同时输出版本号,比如
v20.15.1和10.7.0;如果提示“不是内部或外部命令”,说明 Node.js 根本没进系统 PATH - Windows 用户最常见错误:安装 .msi 包时漏勾了 “Add to PATH” —— 不是重配 VSCode 能解决的,得重装或手动把
C:\Program Files\nodejs\加进系统环境变量 PATH - 加完 PATH 后,必须关闭所有已打开的 CMD/PowerShell 和 VSCode 进程,再全新启动
让 VSCode 继承正确的 PATH
即使系统终端能跑 node,VSCode 内置终端仍可能找不到,因为它的启动方式常绕过 shell 初始化逻辑。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1),免gas,支持macOS/Linux/Windows。触发词:/r
- 在 VSCode 里按
Ctrl + `打开内置终端,立刻执行where node(Windows)或which node(macOS/Linux) - 如果没输出或路径不对,说明 VSCode 没读到你配好的 PATH
- Windows:重装 Node.js 并务必勾选 “Add to PATH”;或者手动把
C:\Program Files\nodejs\加入“系统变量”里的 PATH,然后彻底退出 VSCode 再重启 - macOS/Linux:检查
~/.zshrc或~/.bash_profile是否导出了 Node 路径(如export PATH="/opt/homebrew/bin:$PATH"),改完后必须重启 VSCode,source文件不够
调试前必须验证 launch.json 的 program 字段
VSCode 调试器靠 program 字段定位入口文件,写错路径或变量,断点直接失效,且不会报明显错误。
- 确保你是通过 “文件 → 打开文件夹” 打开整个项目(含
package.json或主 JS 文件),而不是只打开单个.js文件 -
launch.json中"program"必须是相对于${workspaceFolder}的完整路径,例如:"${workspaceFolder}/app.js",不能写成./app.js或app.js - 如果你用的是 ESM 项目,
package.json中必须有"type": "module",否则import会报错,调试器也加载失败 - 不想被
node_modules干扰断点?在配置里加一行:"skipFiles": []
别依赖 Code Runner 插件跑 Node 脚本
它默认命令太简陋,不处理模块类型、编码、输入流,尤其在 ESM 或中文路径下容易假死或报错。
- 用 VSCode 内置终端(
Ctrl + `)手动执行node app.js,行为和真实部署环境一致 - 如果要用 Code Runner,至少在设置中修改
code-runner.executorMap的javascript条目:
ESM 项目:"node --experimental-specifier-resolution=node $fileName"
Windows 中文路径防乱码:"node -r utf-8 $fileName" - 遇到
process.stdin就卡住?Code Runner 不支持交互式输入,换调试模式(F5)或终端手动跑
最容易被忽略的一点:改完环境变量或安装新版本 Node 后,VSCode 必须完全退出再重开,只关终端或重载窗口无效。断点不命中、command not found、调试时报 “Cannot launch program”,90% 都卡在这一步没走通。










