VSCode能运行Node.js的前提是node命令在终端可识别，否则所有功能均失败；根本原因是VSCode GUI进程不继承shell环境变量，需手动配置系统PATH或从终端启动，并验证terminal和debugger双路径一致。
VSCode 能直接运行 Node.js，但前提是 node 命令在终端里能被识别；否则所有调试、运行、插件功能都会卡死在第一步——这不是 VSCode 的 bug，而是环境没配对。
node -v 在系统终端能跑，但在 VSCode 终端里报错
这是最常见也最容易误判的问题。VSCode 启动时读取的是 GUI 进程加载的环境变量，不是你 shell 里改完就生效的 PATH。
- Windows：打开「系统属性 → 高级 → 环境变量」，检查「系统变量」的
Path是否包含 Node.js 安装路径（如C:\Program Files\nodejs），路径中不能有中文或空格 - macOS/Linux：确认
~/.zshrc或~/.bash_profile中有export PATH="/path/to/node/bin:$PATH"，且 VSCode 是从终端用code .启动的，而不是点击 Dock 图标 - 改完环境变量后，必须完全关闭所有 VSCode 窗口再重新打开，
Ctrl+Shift+P→Developer: Reload Window不够，它不重载 PATH
launch.json 里 runtimeExecutable 什么时候必须写
只在你要明确控制 Node.js 版本时才需要显式指定，比如项目要求 v18.19.1，而系统默认是 v20.15.0；或者你在用 nvm、fnm、Volta 等版本管理器。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 不写
runtimeExecutable时，VSCode 按PATH顺序找node，可能和你在终端里执行的不是同一个二进制文件 - 验证方式：在调试时加一行
console.log(process.execPath)，对比输出路径和runtimeExecutable是否一致 - 写死路径（如
"runtimeExecutable": "/usr/local/bin/node"）适合本地开发，但别提交到团队仓库——换人就失效；更可持续的做法是统一用 nvm 并确保终端启动 VSCode
用 Code Runner 插件跑 index.js 报 Cannot use import statement outside a module
Code Runner 默认绕过 package.json，不读 "type": "module"，也不支持 exports 字段，所以它把 ES Module 当成 CommonJS 解析。
- 临时解决：把文件改成
index.mjs，或在package.json里加"type": "module"并确保文件扩展名是.js - 长期建议：禁用 Code Runner 跑 Node.js 脚本，改用 VSCode 内置终端执行
node index.js—— 行为和线上部署一致 - 如果真要用 Code Runner，可在设置里搜
code-runner.executorMap，把javascript对应命令改成node --experimental-specifier-resolution=node（仅限 Node.js ≥14.13）
npm install 成功，但 require() 报 Cannot find module
这不是 Node.js 环境问题，而是 VSCode 的语言服务没正确解析 node_modules 结构，尤其在 monorepo 或用了 npm link 的场景下。
- 先在终端里跑
npm ls lodash（把lodash换成你报错的模块名），确认模块真实存在且没标extraneous - 如果模块是软链接（
npm link），VSCode 可能没监听 symlink 变化，重启 TS Server：Ctrl+Shift+P→TypeScript: Restart TS server - monorepo 项目（如 pnpm workspaces）需在根目录加
jsconfig.json或tsconfig.json，并设"baseUrl": "."和"paths"映射
真正卡住人的从来不是配置项本身，而是 node 是否真的被 VSCode 的终端和调试器“看见”了——两个地方都得验证，缺一不可。
