node -v 报错说明环境根本没通：VSCode未继承shell环境变量，需先确认系统终端能运行node -v，再通过终端启动code .或配置terminal.integrated.env.*并彻底重启VSCode。

node -v 报错说明环境根本没通

VSCode 里 node -v 或 npm -v 报 “command not found”，不是插件或配置的问题，是 Node.js 没进系统 PATH。VSCode 集成终端启动时只继承 shell 的初始环境，不会自动 source 你的 ~/.zshrc 或 ~/.bash_profile。

• 先在系统终端（不是 VSCode 里）运行 node -v 和 npm -v，确认能输出版本号
• Windows 用户重装 Node.js 时务必勾选 Add to PATH；若用 nvm-windows，真实路径通常是 D:\nvm4w\nodejs\node.exe，不是默认的 C:\Program Files\nodejs
• macOS/Linux 强烈推荐用 nvm 管理，执行 nvm use 20 后再运行 which node，把输出路径填进 VSCode 设置里的 terminal.integrated.env.linux 或 terminal.integrated.env.osx
• 改完设置必须彻底退出 VSCode（包括后台进程），再重新打开，否则 PATH 不生效

npm install 后 import 仍标红

波浪线不是“没装上”，而是 VSCode 的语言服务找不到模块路径或类型定义。它和运行时是否成功无关，只管静态解析。

Rydberg Agent Node

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

下载

• 检查项目根目录是否有 jsconfig.json 或 tsconfig.json；没有就新建一个，至少含 {"compilerOptions": {"baseUrl": "."}}
• 用了别名（如 @/utils）？必须在 compilerOptions.paths 里显式声明，且重启语言服务：Developer: Restart Language Server
• @types/xxx 类型包装了但不生效？确认 types 字段没写错，例如 "types": ["node", "jest"]，漏掉 "node" 就会丢全局类型
• ESM 项目里混用 require() 加载 CommonJS 包？类型系统会报错，优先改用 import，或确保 package.json 有 "type": "module"

调试时提示 Cannot find module 或断点不命中

launch.json 里的 program 字段写错，调试器连入口文件都加载不了，更别说 resolve node_modules 了。

• program 必须是真实存在的 JS 文件路径，且以 ${workspaceFolder} 开头，比如 "${workspaceFolder}/dist/index.js" —— 不能写 src/index.ts，也不能写 ./lib/app.js
• TypeScript 项目必须先编译，outDir 要和 program 指向一致，并开启 sourceMaps: true
• 如果用了 nodemon 或其他 wrapper 启动，type 必须是小写 "node"，不是 "pwa-node" 或 "chrome"
• 修改 node_modules 后，必须重启 VSCode（不只是 Reload Window），否则 IntelliSense 缓存仍指向旧版本

插件开发时 module not found

VSCode 插件的依赖和你业务项目的 node_modules 完全隔离。插件报 Cannot find module 'axios'，说明它自己目录下没装。

• 打开插件源码所在文件夹（不是你的业务项目），在终端运行 npm install，不是 npm i axios —— 要按 package.json 里的 dependencies 全量安装
• 确认 node_modules 下真有对应包，比如 node_modules/axios；用 npm ls axios 验证层级
• launch.json 的 program 必须指向编译后的 extension.js（通常是 ${workspaceFolder}/out/extension.js），不是 src/extension.ts
• 不要在 env 里加 NODE_PATH，它会干扰模块解析顺序，尤其当插件和宿主共用同名包时

实际操作中最容易被跳过的是：确认 node 在系统终端可用、program 指向真实 JS 文件、更新依赖后彻底重启 VSCode。这三步卡住，后面所有配置都白搭。