如何在VSCode中配置Node环境构建项目-VSCode-PHP中文网

能跑node命令、npm可用、f5能断点才算配好；必须在系统终端执行node -v和npm -v均输出版本号才过关，windows需手动添加c:\program files\nodejs到path并重启vscode，macos/linux需确认shell配置已生效且which node路径在$path中。

如何在vscode中配置node环境构建项目

能跑 node 命令、npm 可用、F5 能断点，才算配好——其余全是可选项。

验证 node 和 npm 是否真可用

很多人卡在“VSCode 里 node -v 报错”，却去查插件或 launch.json，浪费半天。根本问题不是 VSCode，而是系统环境没生效。

必须在系统终端（macOS 的 Terminal.app、Windows 的 PowerShell/cmd）里执行 node -v 和 npm -v，两者都输出版本号才算过关
Windows 安装时漏选 Add to PATH？手动把 C:\Program Files\nodejs 加进系统环境变量 Path，然后彻底关掉所有 VSCode 窗口再重开
macOS/Linux 用 nvm？确认 source ~/.zshrc（或 ~/.bash_profile）已写入，并新开终端验证 which node 输出路径是否在 $PATH 中
VSCode 内置终端不继承 shell 配置？重启 VSCode 后仍失败，就直接在终端里手动执行 source ~/.zshrc 临时补救

launch.json 中 program 字段别写死

VSCode 自动生成的 launch.json 默认是 "program": "${workspaceFolder}/app.js"，但你项目入口可能是 index.js 或 server.js，一换文件就 F5 失败。

Rydberg Agent Node

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

下载

单文件调试：用 "program": "${file}"，这样无论当前打开哪个 .js 文件，F5 都运行它
固定入口：明确写成 "program": "${workspaceFolder}/index.js"，但务必确保该文件存在且已保存
调试前按 Ctrl+S（Windows/Linux）或 Cmd+S（macOS）——VSCode 默认不自动保存，未保存的断点不会命中
想跑 npm start？改成 "program": "npm"，加 "args": ["start"] 和 "console": "integratedTerminal"，否则看不到启动日志

npm 全局工具和镜像要提前配好

国内不配镜像，npm install 卡住是常态；全局模块装默认路径，C 盘爆满也常见。

换淘宝镜像：npm config set registry https://registry.npmmirror.com
改全局安装路径（比如 D 盘）：npm config set prefix "D:\npm-global"，再把该路径加进系统 PATH
验证配置：npm config get prefix 和 npm config get registry 必须输出你设的值
重装全局工具：npm install -g nodemon，否则 nodemon app.js 在 VSCode 终端里仍会报 command not found

别装过时的 Node.js 调试插件

Node.js Extension Pack、Debugger for Node.js 这类插件现在已废弃，VSCode 自带 vscode-js-debug 就够用，装了反而可能冲突。

确认 node -v 成功后，新建 index.js 写 console.log('ok');
Ctrl+Shift+P → 输入 Debug: Open Configuration → 选 Node.js → Current File
生成的 launch.json 里若出现 "type": "pwa-node" 是新版，没问题；若还是 "type": "node" 也不用动，照样能断点
如果 F5 提示 Cannot find runtime 'node'，100% 是第一步的环境没配对，不是 launch.json 写错了