vscode调试node.js失败主因是环境变量未继承或launch.json配置错误：需确保node/npm在vscode终端可达，program必须为${workspacefolder}开头的绝对路径，typescript项目须配sourcemaps及正确outfiles，web服务推荐attach模式。
VSCode 本身不提供 Node.js 运行时，也**不自带脚手架工具**，所有脚手架（如 @vue/cli、create-react-app、npm init vite@latest）都依赖你本地已正确安装并可调用的 node 和 npm。配置失败的根源几乎全在环境变量或全局路径上，而不是 VSCode 设置本身。
node -v 和 npm -v 在系统终端能运行，但在 VSCode 终端报 command not found
这是最典型的现象，说明 VSCode 内置终端没继承 shell 的环境变量。
- Windows 用户：重装 Node.js 时必须勾选 Add Node.js to PATH；若已装过，手动把
C:\Program Files\nodejs（或你自定义的安装路径）加进「系统环境变量」的Path，然后彻底关闭所有 VSCode 窗口再重新打开 - macOS/Linux 用户：确认
which node输出的路径（比如/opt/homebrew/bin/node）已写入~/.zshrc或~/.bash_profile；VSCode 启动方式很重要——如果从 Dock 或 Spotlight 启动，它可能不读 shell 配置；推荐从终端执行code .打开项目，这样终端环境会完整继承 - 验证方法：在 VSCode 终端里运行
echo $PATH，看输出里是否包含node所在目录；没有就说明没继承成功
全局安装脚手架后，VSCode 终端里仍提示 xxx: command not found
根本原因是 npm 全局模块路径没加入系统 PATH，或者 VSCode 没读到该路径。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 先查当前全局路径：
npm config get prefix，常见输出如C:\Users\XXX\AppData\Roaming\npm（Windows）或/usr/local（macOS 默认）、/opt/homebrew/lib/node_modules（Homebrew 安装） - 把这个路径手动加进系统
PATH（Windows 是系统环境变量；macOS/Linux 加到~/.zshrc末尾并执行source ~/.zshrc） - 别信“重装就解决”——改完
prefix后必须重装工具：npm install -g @vue/cli create-react-app，否则旧版本还在原路径里 - 特别注意：Windows 上如果用了 PowerShell，还要检查执行策略是否阻止了全局命令，临时允许可用
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
用 npm init 创建项目时卡住或报 registry 超时
国内默认 registry 访问极慢甚至不可达，npm init 底层会尝试访问官方源获取模板信息。
- 换镜像不是可选项，是必做项：
npm config set registry https://registry.npmmirror.com - 同时设 disturl（影响 node-gyp 编译）：
npm config set disturl https://npmmirror.com/dist - 验证是否生效：
npm config get registry必须返回镜像地址；npm info lodash能快速返回结果才算真正生效 - 如果仍卡，可能是代理残留：
npm config delete proxy和npm config delete https-proxy清掉旧配置
脚手架创建的项目在 VSCode 里无法调试或断点无效
这不是脚手架问题，而是 VSCode 的 launch.json 没适配框架启动方式。
- Vue CLI 项目不能直接用
"program": "${file}"—— 它靠npm run serve启动 dev server，应选launch type: "pwa-node"并配置"runtimeExecutable": "npm"、"args": ["run", "serve"] - Vite 项目同理，
"args": ["run", "dev"]，且需加"console": "integratedTerminal"才能看到热更新日志 - 断点失效常见于未启用 source map：Vue CLI 默认开启，Vite 也是；但若自己删了
vite.config.js里的build.sourcemap: true，断点就会失效 - 别忽略 package.json 的
"type": "module"—— 如果项目启用了 ESM，而 launch.json 还按 CommonJS 方式配置，require()会报错
最容易被忽略的是：VSCode 调试器对不同脚手架的启动逻辑完全不通用，复制粘贴别人的 launch.json 很可能直接失效；每个框架的 dev server 都是独立进程，必须用 attach 模式或正确配置 runtimeExecutable 才能介入调试流程。
