node -v 报错说明Node.js未正确加入系统PATH，非VSCode配置问题；Windows需勾选Add to PATH，macOS/Linux应确认nvm路径或/usr/local/bin在$PATH中，并用which node或where node验证。

node -v 报错或找不到命令，说明环境根本没通

不是插件或配置的问题，是 Node.js 本身没进系统 PATH。Windows 上安装时务必勾选 Add Node.js to PATH；macOS/Linux 则要确认 ~/.nvm/versions/node/ 或 /usr/local/bin 是否在 $PATH 里。用终端执行 which node（macOS/Linux）或 where node（Windows）验证。如果返回空，VSCode 再装多少插件都没用——它连 node 命令都调不动。

用 nvm 管理多版本 Node，但 VSCode 总用错版本

VSCode 启动时会继承系统 shell 的环境变量，而 nvm 是通过 shell 函数动态切换 node 路径的。直接双击图标启动 VSCode，它往往读不到 nvm 初始化后的 PATH，导致始终用系统默认 Node（比如 /usr/local/bin/node）。

Rydberg Agent Node

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

下载

• macOS：在终端中执行 code . 启动 VSCode，而不是点图标
• Windows：用 PowerShell 启动 VSCode（nvm-windows 对 cmd 支持弱），或在 VSCode 设置里加 "terminal.integrated.defaultProfile.windows": "PowerShell"
• 所有平台：在 VSCode 的 settings.json 中显式指定 Node 路径，例如："node.debug.nodePath": "/Users/you/.nvm/versions/node/v18.19.1/bin/node"

package.json 里有多个 script，但 Code Runner 插件总跑错入口

code-runner 插件默认只认 node $fileName，对 npm run dev 或 yarn start 完全无感。它不读 package.json 的 scripts 字段，也不加载 .env 或 nodemon 配置。

• 想运行 npm run dev？别用右上角三角形按钮，改用 VSCode 内置终端手动敲
• 想一键运行脚本？用 npm 或 yarn 自带的 run 子命令，比如 npx npm-run-all --parallel watch:server watch:client
• 需要热重载？直接装 nodemon 并在 package.json 里写："dev": "nodemon --watch src --exec node src/index.js"

node_modules 不提示、跳转失败、类型推导乱码

这不是 Node 环境问题，是 TypeScript 类型系统和 VSCode 的语言服务没对齐。Node.js 本身不提供类型定义，require() 和 __dirname 这类 API 在纯 JS 项目里没有自动补全。

• 确保项目根目录有 jsconfig.json（JS 项目）或 tsconfig.json（TS 项目），哪怕内容只是 {"compilerOptions": {"allowJs": true}}
• 不要依赖 Node.js Extension Pack——它已多年未更新，反而干扰内置 JS/TS 语言服务
• 如果用了 ESM（type: "module"），注意 require.resolve、__dirname 会失效，得用 import.meta.url + fileURLToPath

VSCode 本身不“管理” Node 包，它只消费 node_modules 提供的类型和路径信息。真正决定行为的是你启动方式（terminal vs GUI）、shell 环境是否干净、以及 jsconfig.json 是否存在——这三个点漏掉任何一个，都会让“多包管理”变成玄学。