能直接在vscode终端输入node并显示版本号才算真正准备好；根本原因是path未正确配置或vscode未继承系统环境变量，需先在系统终端验证node -v/npm -v，再彻底重启vscode。

能直接在 VSCode 终端里敲 node 并看到版本号，才算真正准备好——不是装了 Node.js 就自动可用，PATH 没配对、终端没重启、甚至 Windows 权限问题都会卡在这一步。

为什么 node 命令在 VSCode 终端里报“不是内部或外部命令”

这不是 VSCode 的问题，而是系统根本没把 Node.js 加进环境变量 PATH。VSCode 内置终端启动时，会继承系统 shell 的环境变量，但不会自动 reload；哪怕你刚在系统里改了 PATH，也得重启 VSCode（或至少重启终端）才能生效。

• 先在系统终端（Windows 是 cmd/PowerShell，macOS/Linux 是 Terminal）里运行 node -v 和 npm -v，确认这两个命令本身能跑通
• 如果系统终端里也报错，说明 Node.js 安装时没勾选 Add to PATH，或者手动添加路径时写错了（比如漏了 \node.exe 后缀，或路径含中文/空格）
• 如果系统终端能跑，但 VSCode 里不能，关掉所有 VSCode 窗口再重开——别只关终端，要整个 IDE 重启

node demo.js 运行失败的常见现场

命令能识别，但脚本一跑就报错，多数是路径或模块问题。尤其新手常把文件放在桌面或下载目录，而这些位置默认权限受限，或路径里有空格（如 C:\Users\My Name\Desktop\），node 会静默失败或报 MODULE_NOT_FOUND。

Json Repair Kit

使用 Node.js 评估修复格式错误的 JSON，自动纠正尾随逗号、单引号、未加引号的键等常见问题，实现文件规范化。

下载

• 用 VSCode 的 文件 → 打开文件夹，选一个纯英文、无空格、无中文的路径，比如 D:\projects\node-first
• 新建 demo.js，内容只要一行：console.log('ok');，别急着上 http.createServer
• 确保终端当前工作目录就是这个文件夹：执行 cd 命令后，路径应和左上角 VSCode 标题栏显示的一致
• 运行 node demo.js，而不是 node ./demo.js 或 node .\demo.js——前者最稳，后者在不同 shell 下行为不一致

调试时按 F5 提示 Cannot find runtime 'node'

这个错误和 node 命令不可用是同一根源。VSCode 调试器底层调用的就是系统 node 可执行文件，它不走 npm 或任何包装层。

• 不要装 Node.js Extension Pack 这类过时插件，VSCode 自带 Node.js 调试支持，装了反而可能覆盖默认行为
• 按 Ctrl+Shift+P 输入 Debug: Open Configuration，选 Node.js → Current File，生成的 launch.json 里必须有 "program": "${file}"
• 断点只能打在可执行语句上（比如 console.log 那行），别打在 const 声明或空行——F5 启动后没反应，大概率是断点位置无效

真正卡住人的从来不是语法，而是 node 命令能不能被终端看见。PATH、终端重启、路径合法性，这三件事没理清，后面所有 npm install、nodemon、express-generator 都只是在堆错误。