node 命令能在 VSCode 终端中成功执行（如 node -v）是 Node 环境可用的唯一标志；根本原因在于 VSCode 启动时未加载新配置的 PATH，需彻底重启并验证系统终端中 which/where node 输出路径正确后，再打开 VSCode 测试。

node 命令能在 VSCode 终端里直接执行，才是 Node 运行环境真正可用的唯一标志；其他所有操作——写代码、装插件、点运行按钮——都只是表象，没这一步，全卡死。

为什么 node -v 在系统终端能跑，但在 VSCode 里报错？

这不是 VSCode 的问题，而是它启动时没读到你刚配好的 PATH。Windows 用户常因安装时漏勾 “Add to PATH” 或路径含中文/空格（比如 C:\我的软件\nodejs）导致 npm 静默失败；macOS/Linux 用户若用 nvm，则大概率是 shell 配置没加载（~/.zshrc 或 ~/.bash_profile 里缺 source ~/.nvm/nvm.sh）。

实操建议：

• 完全退出 VSCode（Windows 任务管理器确认 Code.exe 已结束；macOS Dock 右键选「退出」）
• 新开系统终端，运行 where node（Windows）或 which node（macOS/Linux），确认输出路径合理（如 C:\Program Files\nodejs\node.exe 或 /usr/local/bin/node）
• 再打开 VSCode，按 Ctrl + ` 开内置终端，立刻敲 node -v —— 这次的结果才可信

别碰 package.json，先跑通单文件 hello.js

新手最容易在 npm init 和依赖安装上绕远路。其实验证环境只需一个文件：

• VSCode 新建文件 → 保存为 hello.js（扩展名不能省）
• 内容只写一行：console.log("Hello World");
• 终端里手敲 node hello.js（别用右键“运行代码”插件，它会掩盖路径权限问题）
• 看到输出即说明 JS 执行时工作正常；如果报 Cannot find module 'http'，说明根本没 node，不是代码写错了

调试不用装插件，launch.json 三步生成

VSCode 自带 Node.js 调试支持，Node.js Extension Pack 现已过时，装了反而可能冲突。

用于自动切换项目中适合的node 版本

根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。

下载

实操步骤：

• 确保 node -v 和 npm -v 都成功（后者是调试器底层依赖）
• 打开 hello.js，按 Ctrl + Shift + P → 输入 Debug: Open Configuration → 选 Node.js → Current File
• VSCode 自动生成 .vscode/launch.json，其中 "program": "${file}" 表示运行当前文件
• 在代码行号左侧单击设断点，按 F5 启动；若提示 Cannot find runtime 'node'，一定是第一步环境没配好

http 模块服务器跑不起来？先确认 listen() 和端口

新手复制 const http = require('http') 示例后打不开 http://localhost:3000，90% 是因为：

• 漏写了 server.listen(3000)（没有这句，服务根本不启动）
• 端口被占用（可换 3001 或加 console.log('Server running on port 3000') 确认是否真监听了）
• 浏览器缓存了旧响应（关掉页面重开，或用 curl http://localhost:3000 验证）
• 更稳妥的入门方式：先用 express 替代原生 http，npm install express 后写两行就能返回 OK

复杂点在于：环境变量、PATH 加载时机、调试器对 npm 的隐式依赖——这些都不是代码层面的问题，但恰恰卡住最多人。别急着写业务逻辑，先把 node 命令稳稳落在 VSCode 终端里。