根本原因是VSCode未继承shell环境变量：macOS/Linux需设terminal.integrated.shellArgs为["-l"]启用登录shell，Windows应重装Node.js并勾选“Add to PATH”或手动添加路径至系统环境变量，改后须彻底重启VSCode。
node -v 在 VSCode 终端里报 command not found 怎么办
这不是 VSCode 故障，而是它没继承你 shell 里已生效的 node 路径。系统终端能跑 node -v，但 VSCode 里不行，说明环境变量没加载进来。
- 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中通过export PATH="...:$PATH"加入；改完后执行source ~/.zshrc，或直接在终端里运行code .启动 VSCode - VSCode 内置终端缓存旧环境：关掉所有窗口，用命令行启动项目（
code .），别从 Dock 或 Spotlight 点开
launch.json 里 program 字段总出错
program 必须指向一个真实存在的、能被 node 直接执行的 JS 文件，不是 TypeScript 源码，也不是未构建的入口。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 单文件调试：设为
"${file}"，表示运行当前打开的文件；务必先按Ctrl+S（或Cmd+S）保存，否则调试器读的是临时缓存内容 - 固定入口文件（如
index.js）：写成"${workspaceFolder}/index.js"，路径不能含中文、空格，也不能是相对路径如./index.js - 调试
npm start：不能把program设为"npm"就完事；要改成："program": "npm"，"args": ["start"]，并加"console": "integratedTerminal"，否则看不到日志输出 - TypeScript 项目：确保
tsconfig.json启用了"sourceMap": true，且编译后的.js和.js.map在同一目录
Worker Threads 或 fork() 子进程断点不命中
VSCode 默认不调试子进程，autoAttachChildProcesses: true 是开关，不是可选项；但它只对特定启动方式生效。
- 必须在
.vscode/launch.json中显式开启："autoAttachChildProcesses": true - Worker 构造函数需传
execArgv：new Worker('./worker.js', { execArgv: ['--inspect-brk=9229'] })；端口要和 launch.json 的port一致 -
child_process.fork()同样要带execArgv参数：fork('./sub.js', [], { execArgv: ['--inspect-brk=9230'] })；光写fork('./sub.js')不会触发调试 -
spawn()不受autoAttachChildProcesses影响，得手动加--inspect参数，且需配合stdio: 'inherit'才能看到输出 - 若用了
ts-node或esbuild-node启动主进程，autoAttachChildProcesses会失效——它们绕过了标准 Node.js 启动流程
npm 全局工具在 VSCode 里提示 command not found
全局模块（如 nodemon）装了，系统终端能用，但 VSCode 里找不到，大概率是 PATH 没同步，或者装到了非默认位置。
- 先配镜像和自定义全局路径：
npm config set registry https://registry.npmmirror.com，npm config set prefix "D:\npm-global"（Windows）或~/npm-global（macOS/Linux） - 把新路径加进系统
PATH：Windows 加到「系统环境变量」，macOS/Linux 写进~/.zshrc并source - 重装工具：
npm install -g nodemon，验证：npm config get prefix和which nodemon输出应匹配 - VSCode 终端仍不认：重启 VSCode，或在终端里手动执行
source ~/.zshrc；如果用nvm，launch.json 中还得加"runtimeExecutable": "/path/to/nvm/versions/node/v20.15.0/bin/node"
