必须安装Node.js LTS版、勾选“Add to PATH”、配置国内npm镜像源；验证node/npm版本后，可成功初始化Vite+React项目并运行。
要在Windows系统上安装Node.js运行环境来开发前端项目，必须确保安装的是稳定可用的LTS版本、正确配置命令行可执行能力，并让npm能快速下载依赖——这三步缺一不可，否则新建Vue或React项目时会卡在依赖安装环节。
下载并安装Node.js LTS版
打开浏览器，访问 https://nodejs.org/zh-cn/ → 在首页点击【LTS】按钮（不是Current）→ 下载后缀为 .msi 的安装包（如 node-v20.18.0-x64.msi）→ 双击运行。
安装向导中务必勾选 “Add to PATH” 选项，这是让 cmd 或 PowerShell 能直接识别 node 和 npm 命令的关键。若漏选，后续所有命令都会报错 'node' 不是内部或外部命令。
安装路径建议选默认（C:\Program Files\nodejs\），或自定义到 D:\nodejs\ 等无中文、无空格的路径。含中文或空格会导致部分脚手架工具（如 create-react-app）解析失败。
立即学习“前端免费学习笔记（深入）”；
验证基础安装是否生效
按 Win + R → 输入 cmd → 回车打开命令提示符。
依次输入以下两条命令：
node -v
npm -v
若均返回类似 v20.18.0 和 10.9.2 的版本号，说明运行时和包管理器已就位；若其中任一命令报错，请关闭当前窗口，重新打开 cmd 再试——旧终端不会自动读取新添加的 PATH。
配置国内 npm 镜像源（必做）
npm 默认从国外服务器拉包，前端项目 install 依赖时极易超时失败。必须切换为国内镜像源，否则连初始化一个 Vite 项目都可能卡死半小时。
在 cmd 中执行：
npm config set registry https://registry.npmmirror.com
执行后立即验证：
npm config get registry
输出必须是 https://registry.npmmirror.com 才算成功。如果仍显示 https://registry.npmjs.org，则说明上条命令未生效，需检查是否以管理员身份运行了 cmd（某些系统策略下非管理员权限无法写入全局配置）。
设置全局模块安装目录（可选但推荐）
方法一：使用管理员权限创建专用目录
在 Node.js 安装根目录下（例如 C:\Program Files\nodejs\）手动新建两个文件夹：node_global 和 node_cache。
以管理员身份运行 cmd → 执行以下两条命令（路径需与你实际创建位置一致）：
npm config set prefix "C:\Program Files\nodejs\node_global"
npm config set cache "C:\Program Files\nodejs\node_cache"
方法二：跳过手动建目录，用命令自动完成
在管理员 cmd 中直接运行：
mkdir "C:\Program Files\nodejs\node_global" && mkdir "C:\Program Files\nodejs\node_cache" && npm config set prefix "C:\Program Files\nodejs\node_global" && npm config set cache "C:\Program Files\nodejs\node_cache"
这一步做完后，今后全局安装的工具（如 vite、pnpm、http-server）将统一存放在 node_global 中，避免散落在 C:\Users\XXX\AppData\Roaming\npm 下导致权限混乱或磁盘占用失控。
测试前端项目初始化流程
第一步：在任意空白文件夹内打开 cmd（右键 → “在此处打开终端”）。
第二步：运行 npx create-vite@latest my-app -- --template react → 按提示选择框架和预设。
第三步：进入项目目录 → cd my-app → npm install → npm run dev。
若浏览器自动弹出 http://localhost:5173 并显示 React 欢迎页，说明整个 Node.js 前端开发环境已完整就绪。
