能跑 node -v 就算环境通了一半；断点不生效、require 报错、npm install 成功但模块找不到——这些问题 90% 不是代码或插件问题，而是 VSCode 没拿到和终端一致的 PATH 或调试配置没对齐运行时。
能跑 node -v 就算环境通了一半；断点不生效、require 报错、npm install 成功但模块找不到——这些问题 90% 不是代码或插件问题，而是 VSCode 没拿到和终端一致的 PATH 或调试配置没对齐运行时。
验证 node 和 npm 是否真被 VSCode 终端识别
别信安装界面勾了“Add to PATH”就万事大吉。VSCode 启动时读取的是 GUI 进程加载的环境变量，而很多安装方式（尤其是 Windows 上的默认安装、macOS 上用 nvm 但没配 shell 初始化文件）会导致终端能跑 node -v，但 VSCode 调试器报 Command "node" not found。
- 关掉所有 VSCode 窗口，彻底退出进程（Windows 查任务管理器确认
Code.exe已结束；macOS 在 Dock 右键选「退出」） - 打开系统终端（不是 VSCode 内置终端），运行
where node（Windows）或which node（macOS/Linux），确认路径合理（如C:\Program Files\nodejs\node.exe或/usr/local/bin/node） - 再启动 VSCode，在内置终端（
Ctrl+`）里立刻执行node -v和npm -v—— 这个结果才是 VSCode 实际能调用的 - 如果失败，Windows 用户检查系统环境变量
Path是否含 Node.js 安装目录；macOS/Linux 用户检查~/.zshrc或~/.bash_profile是否有export PATH=...并已source过
launch.json 中 runtimeExecutable 什么时候必须写？
只在你明确需要绕过系统 PATH 查找逻辑时才显式指定 runtimeExecutable，比如：用 nvm 切了版本但 VSCode 没继承、调试 Electron 内置 runtime、或在 WSL/容器中开发。硬编码路径会让团队协作崩掉，也违背 Node.js 版本管理原则。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 常见错误：为“统一版本”在
launch.json里写死"runtimeExecutable": "/Users/you/.nvm/versions/node/v18.19.1/bin/node"—— 这会卡死其他成员 - 正确做法：用
nvm use 18后再从终端启动 VSCode（code .），让PATH自然生效 - VSCode 1.85+ 支持
runtimeVersion字段，但它只告警不切换，不能替代nvm use - 验证是否生效：在
index.js里加console.log(process.execPath)，对比调试输出路径和你预期的node路径是否一致
为什么 npm install 成功却报 Cannot find module？
这不是 Node.js 环境没装好，而是 VSCode 的语言服务没理解你的项目结构。常见于 monorepo、软链接依赖（npm link）、或 package.json 缺少 "type": "module" 导致 CJS/ESM 解析错乱。
- 先在终端运行
npm ls <code>express（把express换成你报错的模块名），确认它真实存在且没标extraneous - 检查
package.json是否有"type": "module"；如果有，所有.js文件都按 ESM 解析，require()会直接报错 - monorepo 场景下，确保
tsconfig.json或jsconfig.json里配置了"baseUrl"和"paths"，否则 VSCode 的跳转和提示会失效 -
node_modules被放在父目录（比如 lerna 根目录），而当前工作目录是子包 —— 此时require会从子包目录向上找，可能找不到
别用 Code Runner 插件跑 Node.js 脚本
它默认不加载 package.json 的 "type"、不传 --experimental-specifier-resolution=node、不支持 stdin 输入，遇到 ESM、中文路径、交互式脚本基本必翻车。
- 临时验证单文件逻辑可以，但正式开发中建议禁用，改用内置终端手动执行
node index.js - 如果非要保留 Code Runner，得改
settings.json里的code-runner.executorMap："javascript": "node --experimental-specifier-resolution=node $fileName"（macOS/Linux）"javascript": "node -r utf-8 --experimental-specifier-resolution=node $fileName"（Windows 中文环境） - 含
process.stdin.on('data', ...)的脚本，Code Runner 完全不支持输入，必须切到终端手动运行 - 调试一律用 VSCode 原生调试器（F5），它支持断点、作用域变量监视、调用栈回溯，比一键运行靠谱得多
真正卡住人的地方，往往不是语法或框架，而是 VSCode 没拿到和终端一致的 PATH，或是你以为在项目根目录，其实只是打开了一个孤立文件——先确认 node -v 和 npm init -y 都能在 VSCode 终端里成功执行，再动其他配置。
