VS Code新建Node.js项目本质是手动创建文件夹并初始化package.json。需先安装node/npm，再通过终端执行mkdir、cd、npm init等命令，最后创建入口文件；VS Code仅编辑文件，不自动构建项目。
vscode 里新建 Node.js 项目，本质是建文件夹+初始化 package.json
VS Code 本身不提供“新建 Node.js 项目”按钮，它只是编辑器。真正创建 Node.js 项目的动作发生在终端里，VS Code 只负责打开和编辑这些文件。
你得先在系统里有 node 和 npm（或 pnpm/yarn），否则后续所有操作都会卡在“找不到命令”上。
- 打开 VS Code，按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入Terminal: Create New Terminal回车 - 在终端里执行
mkdir my-app && cd my-app - 运行
npm init -y（快速生成默认package.json）或npm init（交互式填写） - 再手动创建入口文件，比如
touch index.js（Mac/Linux）或type nul > index.js（Windows）
为什么不能直接点“新建 Node.js 文件”就跑起来？
Node.js 不是靠文件后缀识别的，而是靠执行环境。一个 .js 文件只有被 node 命令显式调用，才会以 Node 模式运行。VS Code 默认只是把它当普通文本打开。
- 右键新建
index.js→ 它只是个空文件，没内容、没依赖、没package.json，node index.js会报错或什么也不做 - 想一键运行？得先确保当前文件夹是有效 Node 项目（含
package.json），再用Ctrl+Shift+P→Run: Start Without Debugging，并选中Node.js环境 - 如果没配置好调试器，VS Code 会提示“无法找到程序”，实际就是缺
.vscode/launch.json或路径不对
常见错误：Cannot find module 或 command not found: node
这两个错误出现频率最高，但原因完全不同，别混着查。
-
command not found: node→ 系统 PATH 没包含 Node 安装路径。Mac/Linux 检查which node；Windows 检查系统环境变量里的Path是否含node.exe所在目录 -
Cannot find module 'xxx'→ 通常是require('xxx')对应的包没装，或者用了 ES Module 语法（import）但没在package.json里写"type": "module" - 新项目里写了
import fs from 'fs'却报错？大概率是漏了"type": "module"，或者用了老版本 Node（await
要不要装 VS Code 插件来“辅助新建”？
插件如 Node.js Extension Pack 或 Auto Import 不参与项目创建流程，它们只影响代码编写体验。真正省事的方式是用脚手架，不是插件。
- 想快速生成带基础结构的项目？用
npm init [template]，比如npm init express（需全局装express-generator）或npm init vite@latest（选 Node + Node.js 模板） - VS Code 的
File > Open Folder必须指向含package.json的文件夹，否则左侧 Explorer 不会显示 npm 脚本，右下角也不会提示 Node 版本 - 别依赖插件自动生成
launch.json：手动建.vscode/launch.json更可靠，内容只需三行关键字段：type、request、program
最常被忽略的是：Node.js 项目从创建到可调试，中间必须经过“终端初始化 → 文件编写 → 配置识别 → 运行验证”这四步，跳过任何一环，VS Code 就只是个高级记事本。
