VSCode中npm -v报错是因终端未继承shell环境变量，需手动切换shell、修正PATH、重装Node.js、配置runtimeExecutable及code-runner执行命令，并分别验证node/npm/F5/Code Runner四通道。
node -v 能跑，npm -v 报错：环境变量没继承进 VSCode 终端
VSCode 启动时不会自动加载你 shell 配置文件（比如 ~/.zshrc 或 ~/.bash_profile）里的 PATH，尤其 macOS 上用 zsh 但 VSCode 默认终端没读取它，就会出现 node -v 成功、npm -v 找不到的情况。
实操建议：
- 在 VSCode 终端右上角点击「+」旁的小箭头，手动切换 profile 到你日常用的 shell（比如
zsh或Command Prompt） - Mac/Linux 用户检查
~/.zshrc是否有这行：export PATH="/usr/local/bin:$PATH"（Homebrew 安装 Node 默认路径）；没有就加上，然后运行source ~/.zshrc - Windows 用户确认安装 Node.js 时勾选了
Add to PATH；没勾就重装，或手动把C:Program Files odejs加进系统环境变量的Path - 改完必须关掉所有 VSCode 窗口，再重新打开——旧终端进程不会自动 reload 环境变量
where npm / which npm 返回空：npm 根本没装进系统路径
Node.js 安装包自带 npm，但某些定制安装（比如用 nvm、或企业版静默部署）可能跳过 npm，或者 npm 被误删。此时 node -v 正常，npm -v 直接报“command not found”。
实操建议：
- 先运行
ls -la $(dirname $(which node))/../lib/node_modules/（Mac/Linux）或dir "C:Program Files odejs ode_modules"（Windows），看里面有没有npm文件夹 - 没有？说明 npm 没随 Node 一起装。不要单独下载 npm，直接重装 Node.js LTS 版，安装时务必勾选
Automatically install the necessary tools - 重装后仍不识别，检查是否被杀毒软件拦截（如 360、腾讯电脑管家曾清掉
npm.cmd）；临时关闭再试 - 别用管理员权限运行 VSCode 启动终端——这反而可能隔离用户级环境变量
F5 调试报 “Can’t find Node.js binary ‘node’”：launch.json 没兜底
VSCode 调试器（vscode-js-debug）默认只认 PATH 里的 node，一旦环境变量失效，它不会 fallback，而是直接崩溃，错误信息里明确提示找不到 node 二进制。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
实操建议：
- 打开任意
.js文件，按F5→ 选Node.js→ 自动生成.vscode/launch.json - 编辑该文件，在
configurations里加字段："runtimeExecutable": "/usr/local/bin/node"（Mac/Linux）或"runtimeExecutable": "C:\Program Files\nodejs\node.exe"（Windows） - 路径必须是绝对路径，且结尾是可执行文件（不是文件夹），注意 Windows 反斜杠要双写或用正斜杠
- 这个配置只对当前项目生效；如果多个项目路径不同，建议统一用 nvm 或 fnm 管理 Node 版本，避免硬编码路径
Code Runner 插件运行 JS 卡住或乱码：执行命令没适配平台和编码
code-runner 默认用 node $fileName 执行，但它不处理中文路径、不设字符编码、也不支持 process.stdin 输入，容易假死或输出乱码。
实操建议：
- 打开 VSCode 设置，搜
code-runner.executorMap，找到javascript对应项 - 改成：
"node --experimental-specifier-resolution=node $fileName"（兼容 ES Module） - Windows 用户加
-r utf-8："node -r utf-8 --experimental-specifier-resolution=node $fileName" - 别用它跑需要用户输入的脚本（比如含
readline或prompt-sync），这类脚本必须在原生终端里手动运行
最常被忽略的是：VSCode 终端启动时的 shell profile 和系统环境变量不是一回事，而调试器和插件又各自读取不同路径。修一个地方，未必能同步修复所有入口——得分别验证 node、npm、F5 调试、Code Runner 四个通道是否都通。
