能跑 node 命令且 vscode 可断点调试才算真正搭好；先在系统终端执行 node -v 和 npm -v，若报“不是内部或外部命令”，说明 node.js 未加入 path，需勾选安装时的 add to path 或手动添加安装目录至系统环境变量 path 并重启终端。
能跑 node 命令，且 VSCode 能断点调试，才算真正搭好——其余插件、格式化、TypeScript 都是锦上添花，不是刚需。
验证 node 和 npm 是否真可用（别跳过这步）
很多人卡在这一步却以为是 VSCode 的问题。打开系统终端（不是 VSCode 内置终端），执行：
node -v npm -v
如果报错 'node' 不是内部或外部命令，说明 Node.js 没进系统 PATH。LTS 版安装时勾选 Add to PATH 是关键；若漏了，需手动把 Node.js 安装目录（如 C:\Program Files\nodejs）加到系统环境变量 Path 里，然后重启所有终端窗口。
- Windows 用户注意：不要装在含中文或空格的路径下（如
D:\我的软件\nodejs），否则npm可能静默失败 - macOS/Linux 用户若用
nvm，确保source ~/.nvm/nvm.sh已写入 shell 配置文件，且新终端已加载 -
npm -v必须成功——VSCode 的调试器底层依赖npm启动脚本，不是可选项
VSCode 内置调试器直接可用，无需额外插件
VSCode 自带 Node.js 调试支持，Node.js Extension Pack 或 Debugger for Node.js 这类插件现在已过时，装了反而可能冲突。确认 node 可用后，只需三步：
- 新建项目文件夹，在其中创建
index.js，写一行console.log('ok'); - 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Debug: Open Configuration，选择Node.js → Current File - VSCode 会自动生成
.vscode/launch.json，内容含"program": "${file}"——这表示“运行当前打开的 JS 文件”
此时在代码行号左侧单击设断点，按 F5 即可启动调试。若提示 Cannot find runtime 'node'，一定是第一步的 node 环境没配好，不是 VSCode 设置问题。
launch.json 中常见配置陷阱
默认生成的配置适合单文件调试，但实际开发中容易踩坑：
- 想调试
npm start？把"program"改成"npm"，"args"设为["start"]，并加"console": "integratedTerminal"，否则看不到npm输出 - 用
nodemon热重载？不能直接在launch.json里调nodemon——VSCode 调试器不支持进程热替换，必须用attach模式：先命令行跑nodemon --inspect-brk index.js，再在launch.json中配置"type": "node"+"request": "attach"+"port": 9229 - 确保你在 VSCode 里是通过“文件 → 打开文件夹”打开整个项目（比如含
package.json或app.js的文件夹），而不是只打开单个 JS 文件
npm install -g 全局命令在 VSCode 终端里找不到
比如装了 http-server 或 nodemon，CMD 能用，VSCode 终端却说 command not found——这基本等于全局 bin 目录没进 PATH。
- 如果你手动改过 npm 全局路径（比如执行过
npm config set prefix），就必须把那个新路径（如D:\software\nodejs\node_global）加进系统环境变量PATH里 - 加完后，关闭并重开 VSCode（不是仅重启终端），否则它读不到更新后的 PATH
- 在 VSCode 内置终端里立刻执行
node -v和which nodemon（macOS/Linux）或where nodemon（Windows），确认路径一致
最容易被忽略的是：VSCode 启动时读取的是它启动那一刻的环境变量快照，改完 PATH 不重启 VSCode 进程，内置终端永远看不到新命令。
