VSCode找不到node命令的根本原因是未继承shell配置或系统PATH未写入Node路径：Mac/Linux用户需确保~/.zshrc生效并从终端执行code .启动；Windows用户须重装Node时勾选“Add to PATH”或手动添加C:\Program Files\nodejs\到系统环境变量。
VSCode 找不到 node 命令怎么办
不是 VSCode 配置错了，而是它没继承你终端里已有的 node 环境。Mac/Linux 用户常见于 ~/.zshrc 里写了 export PATH，但 VSCode 启动时压根没加载这个文件；Windows 用户基本是安装 Node.js 时漏勾了 “Add to PATH”。
- 先在终端里运行
which node（Mac/Linux）或where node（Windows），确认路径真实存在 - Mac/Linux：按
Cmd+Shift+P→ 输入Developer: Reload Window，强制重载 Shell 初始化逻辑；仍不行就从终端启动 VSCode：code . - Windows：重装 Node.js，务必勾选 “Add to PATH”；若不想重装，手动把
C:\Program Files\nodejs\加进系统环境变量PATH
launch.json 调试时报 “Cannot find runtime 'node'”
这是调试器找不到 Node.js 运行时，和终端能跑 node -v 是两回事——调试器只认 launch.json 里的 runtimeExecutable 或全局 PATH。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 检查项目根目录下是否有
.vscode/launch.json，里面configurations是否误写了"runtimeExecutable": "/wrong/path/node"；有就删掉这行，让它走默认查找 - 用了
nvm/fnm等版本管理工具？调试器不自动识别切换逻辑，得显式写死路径，比如："runtimeExecutable": "~/.nvm/versions/node/v18.17.0/bin/node" - 用
ts-node或esbuild-node启动 TS 文件？断点大概率失效，应改用node --loader ts-node/esm模式，并在launch.json中配"runtimeArgs"
静态资源强缓存要靠 HTTP 头，不是 VSCode 配置
VSCode 本身不参与 HTTP 响应头控制，强缓存必须由服务端代码或代理层注入 Cache-Control、ETag 等字段。本地开发常用 express 或 serve，它们默认不开启强缓存。
- 用
express.static时加maxAge：app.use(express.static('public', { maxAge: '1y' }))→ 输出Cache-Control: public, max-age=31536000 - 用
serveCLI？加-c参数：npx serve -s public -c 1y - 别信某些插件声称“VSCode 内置静态服务器支持缓存”——它只是个简易 HTTP server，没暴露缓存配置入口
为什么改了 package.json 的 type 字段后断点失效
因为 "type": "module" 会让 Node.js 以 ESM 模式解析 JS，而 VSCode 调试器默认按 CommonJS 解析源映射，两者 mismatch 导致断点挂不上。
- 确保
launch.json中有"type": "pwa-node"（新版调试器必需） - ESM 项目必须配
"runtimeArgs": ["--loader", "ts-node/esm"]（TS）或"--experimental-specifier-resolution=node"（纯 JS） - 如果用了
import但没设"type": "module"，Node.js 会报错；设了又没配调试参数，断点就静默失效——这是最常被忽略的耦合点
