VS Code 不提供“新建 Node.js 项目”按钮，需在终端手动创建文件夹、初始化 package.json 并编写入口文件；必须先确认 node 和 npm 已正确配置到系统 PATH，否则后续操作均会失败。
VS Code 本身不提供“新建 Node.js 项目”按钮，所谓“新建”，就是你在终端里手动创建文件夹、初始化 package.json、写入口文件——VS Code 只负责打开和编辑它们。
确认 node 和 npm 已真正可用
这是所有后续操作的前提，跳过这步，后面全会卡在 command not found: node 或 Cannot find module 上。
- 别只在 VS Code 内置终端里试，先打开系统终端（macOS/Linux 的 Terminal，Windows 的 CMD/PowerShell），执行：
node -v和npm -v - Windows 用户若安装时没勾选 Add to PATH，或装在含中文/空格路径（如
C:\Program Files\nodejs是 OK 的，但D:\我的软件\nodejs不行），node命令大概率失效 - macOS/Linux 用
nvm的，检查source ~/.nvm/nvm.sh是否已写入~/.zshrc或~/.bash_profile，并新开终端验证
在终端里完成项目初始化（不是在 VS Code 图形界面点右键）
VS Code 不参与项目结构生成，它只是编辑器。你得自己在终端里走完这几步：
mkdir my-app && cd my-app-
npm init -y（快速生成默认package.json）或npm init（交互式填写） - 创建入口文件：
touch index.js（macOS/Linux）或type nul > index.js（Windows） - 此时再用 VS Code 打开这个文件夹：
code .（命令行执行）或菜单 File → Open Folder
注意：index.js 为空文件时，直接 node index.js 不报错但也没输出；加一行 console.log('ok'); 才算真正可运行。
调试前必须生成 launch.json，且依赖 node 可用
VS Code 自带 Node.js 调试支持，不需要额外插件（Node.js Extension Pack 等已过时，装了反而可能冲突）。
- 确保
index.js已打开，按Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Debug: Open Configuration，选Node.js → Current File - VS Code 会自动生成
.vscode/launch.json，关键字段是"program": "${file}"，表示运行当前 JS 文件 - 若此时按
F5提示Cannot find runtime 'node'，不是配置问题，而是第一步的node环境根本没配好 - 想调试
npm start？改launch.json："program": "npm"，"args": ["start"]，并加"console": "integratedTerminal"，否则看不到 npm 输出
常见错误和对应动作
两个高频错误经常被混为一谈，但解决路径完全不同：
-
command not found: node→ 查系统 PATH，不是 VS Code 设置问题 -
Cannot find module 'xxx'→ 先看require('xxx')对应的包是否已npm install xxx；再检查package.json里有没有"type": "module"（用了import却没声明，就会报这个） - 写了
import fs from 'fs'却报错？不是语法错，是 Node 版本太低（await）或漏了"type": "module"
真正省事的方式是用脚手架（比如 npx express-generator），而不是找“一键新建 Node 项目”的插件——插件不生成项目，只影响编码体验。
