vscode内置终端找不到node命令的根本原因是未继承系统shell的path环境变量。mac/linux用户需确保shell配置文件（如~/.zshrc）生效并重启vscode，或用code .启动；windows用户需手动将node.js安装路径添加到系统path并重启vscode，最终以node -v在终端中成功输出为准。
VSCode内置终端找不到node命令
根本不是VSCode配置错了，而是它启动时没继承你shell里已生效的PATH。Mac/Linux用户常因~/.zshrc或~/.bash_profile里加了node路径但VSCode没加载；Windows用户则多因安装Node.js时漏选“Add to PATH”。
- 先在系统终端（不是VSCode里）运行
which node（Mac/Linux）或where node（Windows），确认路径真实存在 - Mac/Linux：改完shell配置后，必须重启VSCode；更稳妥的是从终端执行
code .启动 - Windows：打开“系统属性 → 高级 → 环境变量”，把
C:\Program Files\nodejs\加进“系统变量”的PATH，然后关掉所有VSCode窗口再重开 - 验证方式只有一种：在VSCode内置终端（
Ctrl + `）里敲node -v，有输出才算过关
code-runner插件跑JS脚本乱码或报Cannot use import statement
这个插件默认用node $fileName执行，不处理编码、模块类型和输入流，尤其在中文路径或ESM项目下容易崩。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- Windows乱码：在VSCode设置里搜
code-runner.executorMap，把javascript对应值改成：node -r utf-8 $fileName - ESM报错：确保项目根目录
package.json含"type": "module"，再把executor改成：node --experimental-specifier-resolution=node $fileName - 遇到
process.stdin就假死——code-runner根本不支持交互式输入，换用内置终端手动运行，或直接按F5走调试模式
调试时断点不生效，提示Cannot launch program
这不是代码写错了，而是VSCode调试器找不到可执行的JS文件，或者源映射没对上。
-
launch.json里的program字段必须指向一个真实存在的、能被node直接执行的JS文件，比如${workspaceFolder}/dist/index.js，不能是.ts或.mjs源文件 - TypeScript项目必须在
tsconfig.json中开启"sourceMaps": true，且编译后.js.map和.js必须在同一目录 - 如果用了
nvm/fnm，调试器默认不识别版本切换逻辑；稳妥做法是在launch.json里显式写"runtimeExecutable": "~/.nvm/versions/node/v18.17.0/bin/node"
为什么npm start在终端能跑，VSCode任务却失败
VSCode任务系统默认复用集成终端的Shell，但它可能用了不同Shell（比如VSCode默认用zsh，而你平时用bash），导致环境变量不一致。
- 检查
.vscode/tasks.json是否指定了"shell": {"executable": "/bin/zsh"}之类，跟你的日常Shell不一致 - 更简单的方式：在
tasks.json里加"env": {"PATH": "${env:PATH}"}，强制继承当前终端环境 - 如果项目依赖
nodemon热重载，别在launch.json里直接调nodemon——调试器不支持热替换，得用attach模式：先终端跑nodemon --inspect-brk index.js，再配"request": "attach"和对应port
launch.json怎么写，而是node命令本身在VSCode里就不可见——所有后续调试、任务、插件都建立在这个前提上。很多人反复重装插件、修改配置，却忘了先在内置终端里敲一遍node -v。
