根本原因是VSCode图形界面启动时未加载shell配置文件（如~/.zshrc）或Windows未勾选“Add to PATH”，导致PATH缺失；需验证which node/where node，macOS/Linux从终端执行code .启动，Windows手动添加Node路径到系统环境变量。
为什么 node 在终端能跑，但在 VSCode 里报错“command not found”
根本不是 VSCode 配置错了，而是它没继承你 shell 的环境变量。Mac/Linux 下，~/.zshrc 或 ~/.bash_profile 里写的 PATH，VSCode 图形界面启动时压根没加载；Windows 则大概率是安装 Node.js 时漏选了 “Add to PATH”。
- 先确认真实路径：
which node（Mac/Linux）或where node（Windows），看输出是否非空 - Mac/Linux：按
Cmd+Shift+P→ 输入Developer: Reload Window，强制重载 shell 环境；仍不行就从终端执行code .启动 VSCode - Windows：打开系统环境变量设置，把 Node.js 安装目录（如
C:\Program Files\nodejs\）手动加进PATH，重启 VSCode
launch.json 中断点不生效的常见原因
能运行 node app.js ≠ 调试器能接管进程。VSCode 的 Node.js 调试器依赖 launch.json 的配置逻辑，和终端 PATH 是两套体系。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 检查
.vscode/launch.json是否存在；若不存在，用Ctrl+Shift+P→Debug: Open Configuration自动生成 - 不要硬编码
runtimeExecutable，除非你用nvm/fnm；删掉这行，让调试器走默认查找路径 - 如果项目用
ts-node或esbuild-node启动 TS 文件，断点必然失效 —— 改用node --loader ts-node/esm模式，并在launch.json的runtimeArgs里显式写入 - 确保
program字段设为"${file}"（而非固定文件名），否则每次换文件都要改配置
如何让团队成员开箱即用，不调格式、不配插件、不断点失败
靠口头约定或文档说明不如直接把规则固化进项目。工作区配置的核心价值，就是把“应该怎么做”变成“只能这么做”。
-
.vscode/settings.json必须包含："editor.tabSize": 2、"files.insertFinalNewline": true、"editor.formatOnSave": true，并指定 Prettier 为 JS/TS 默认 formatter -
.vscode/extensions.json声明推荐插件（如esbenp.prettier-vscode、dbaeumer.vscode-eslint），新成员打开项目时会收到提示 -
package.json中定义"type": "module"或"type": "commonjs"，避免 VSCode 语言服务误判模块解析逻辑 - 禁用全局启用的第三方 JS 补全插件（比如某些“增强型 JavaScript 支持”），它们常与内置 TypeScript 语言服务冲突，导致跳转失效
为什么 tasks.json 里 npm 命令总失败，但终端里好好的
VSCode 的任务系统默认不读取 shell 初始化文件，也不继承终端当前 session 的环境变量 —— 它启动的是干净的子进程。
- 在
.vscode/tasks.json的options.env里手动补全关键变量，例如："NODE_ENV": "development"、"PATH": "/opt/homebrew/bin:/usr/local/bin:${env:PATH}" - 避免在
tasks.json里直接写"command": "npm run dev"；改用"command": "sh"+"args": ["-c", "npm run dev"]，确保 shell 解析生效 - 如果用了
nvm，任务里必须先 source 对应 profile，比如"args": ["-c", "source ~/.nvm/nvm.sh && nvm use 18 && npm run build"]
package.json 的 "type" 字段和 .vscode/extensions.json 的存在 —— 它们不报错，但缺失后会导致格式化失效、类型提示不准、插件不自动激活，问题分散且难以归因。 
