根本不是VSCode的问题，而是Windows未将Node.js加入系统PATH；需下载LTS版安装时勾选“Add to PATH”，或手动添加C:\Program Files\nodejs到系统环境变量Path并彻底重启VSCode。

node -v 报错：根本不是 VSCode 的问题

VSCode 本身不带 Node.js，它只调用系统已安装的 node。报 'node' 不是内部或外部命令，说明 Windows 没把 Node.js 加进系统 PATH，而不是 VSCode 配错了。

• 去 nodejs.org/download 下载 LTS 版本（如 v20.15.1），运行 .msi 安装包时必须勾选 “Add to PATH”
• 安装完后，关闭所有 CMD/PowerShell/VSCode 窗口，重新打开一个 CMD，执行 node -v 和 npm -v —— 有输出才算真正装好
• 如果仍失败，手动把 Node.js 安装目录（如 C:\Program Files\nodejs）加到系统环境变量 Path 里，再重启全部终端
• 别信“在 VSCode 扩展里搜 Node.js 插件就能装运行时”——那些插件（如 Node.js Extension Pack）只提供语法支持，不带 node.exe

VSCode 终端找不到全局 npm 工具（如 nodemon）

你在 CMD 里能用 nodemon，但在 VSCode 终端里提示 command not found，大概率是 npm 全局 bin 目录没进 PATH。

Rydberg Agent Node

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

下载

• 先查 npm 全局路径：npm config get prefix，常见值如 C:\Users\XXX\AppData\Roaming\npm 或你自定义的 D:\npm-global
• 把这个路径手动加进系统环境变量 Path（不是用户变量，是系统变量）
• 加完后必须完全退出 VSCode 进程（任务管理器里确认 Code.exe 已结束），再重新打开项目文件夹
• 如果改过 prefix 却没重启 VSCode，npm install -g nodemon 装对了，但 VSCode 就是找不到——它读的是旧 PATH 缓存

launch.json 中 program 字段填错，调试直接静默退出

VSCode 调试器启动失败，控制台空转几秒就退出，90% 是 program 指向了一个不存在的文件，或者指向了源码而非编译后 JS。

• 默认生成的 "program": "${workspaceFolder}/index.js" 很容易不存在——检查你项目根目录下真有这个文件吗？没有就改成 "${workspaceFolder}/app.js" 或对应入口名
• 想临时调试当前打开的 JS 文件？用 "${file}"，别写成 ${fileBasename} 或 ${relativeFile}
• TS 或 ESM 项目别写 src/index.ts——调试器只认 JS，必须指向 dist/index.js 这类已构建产物
• "type": "node" 和 "request": "launch" 是调试器识别关键，动错一个，整个配置就失效

npm install 后 import 仍标红，不是插件没装

VSCode 里 import express from 'express' 底下持续波浪线，不是缺插件，而是类型定义、路径解析或缓存没跟上。

• 确保执行的是完整命令 npm install express，别只敲 npm i express（某些旧版 npm 对缩写支持不稳定）
• 检查 jsconfig.json 或 tsconfig.json 是否配置了 "types" 或 "typeRoots"，尤其用了 @types/express 时
• ESM 项目里混用 require() 加载 CommonJS 包，可能触发类型不匹配；优先改用 import，或在 package.json 加 "type": "module"
• node_modules 更新后，务必完全重启 VSCode（不只是 Reload Window），否则 IntelliSense 仍按旧快照工作

真正卡住人的，从来不是 npm 命令怎么敲，而是 VSCode 没读到你 shell 里已生效的 PATH 或 npm 配置。关掉所有窗口、重开、再验证，比反复配插件管用得多。