先确认系统终端中 node -v 和 npm -v 能正常执行，再检查 path 配置、vscode 终端环境继承、package.json 与 node_modules 同步、launch.json 入口路径正确性、类型定义加载及 vscode 缓存重启。
node -v 报错时别急着配依赖
VSCode 里装再多插件、写再全的 package.json，只要 node -v 在系统终端里报 “command not found”，所有本地包管理都跑不起来——这不是配置问题，是环境没到位。
- 先在**系统终端**（不是 VSCode 集成终端）运行
node -v和npm -v，确认 Node.js 真的装好了 - Windows 用户检查安装时是否勾选了 Add to PATH；macOS/Linux 强烈建议用
nvm管理版本，避免权限和路径冲突 - 即使终端能跑，VSCode 有时会继承错误 shell 环境：PowerShell 和 CMD 的
$env:PATH/%PATH%不共享，需在设置里显式填入"terminal.integrated.env.windows"或启用 login shell（shellArgs: ["-l"]）
package.json 改了但 node_modules 没同步？
手动编辑 package.json 中的版本号后直接保存，VSCode 不会自动触发安装——这会导致声明与实际不一致，后续运行必报 Cannot find module 或类型缺失。
- 改完
package.json后，必须执行npm install（不是npm i缩写，某些旧版 npm 对缩写支持不稳定） - 若只更新单个包，用
npm install express@4.18.2；想升到最新兼容版，用npm update express -
npm install后模块仍标红？检查三处：jsconfig.json是否启用了"typeRoots"，@types/xxx是否已装，ESM 项目是否漏加"type": "module"到package.json
launch.json 的 program 字段怎么填才不炸
program 字段填错，调试器直接卡在 Cannot find module 或静默退出——它连入口文件都找不到，更别说解析 node_modules 了。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 默认生成的
"${workspaceFolder}/index.js"很容易不存在，改成"${workspaceFolder}/app.js"并确保该文件真实存在 - 想临时调试当前打开的 JS 文件？用
"${file}"，不是${fileBasename}，也不是${relativeFile} - TS 或 ESM 项目必须指向编译后 JS（如
dist/index.js），不能写src/index.ts，否则会触发ERR_REQUIRE_ESM
npm install 后 VSCode 还认不出新包？
VSCode 不会自动重载类型定义和路径索引——你看到的“未找到模块”提示，大概率是旧缓存还在。
- 修改
node_modules后，务必**重启 VSCode（不只是 Reload Window）**，否则 IntelliSense 和调试器仍按旧快照工作 - 如果用了
npm-check交互式更新，更新完立刻关掉所有打开的 JS/TS 文件，再重新打开，避免编辑器持旧引用 - 大型项目中，
node_modules/.vscode目录偶尔会残留错误缓存，可手动删掉（不影响依赖本身）
最常被跳过的其实是：确认 VSCode 继承的是你真正想用的那个 Node 版本，而不是某个旧全局安装或 nvm 默认 alias 指向的失效路径。路径对了，node_modules 才算真正“在本地”。
