4. Node.js / 前端
本章共 3 篇详细教程（含 .msi / .exe 一键安装步骤），建议按顺序完成。安装包见「开发工具」各项目页网盘。
1. Node.js 安装（.msi 一键安装，推荐 Node 20.18）
推荐使用安装包内的 Node 20.18（Windows Installer .msi），自动配 Path。
安装包下载：/tools/springboot3-vue3
- 双击
node-v20.18.x-x64.msi，Next。 - 接受协议 → Next。
- 安装路径可默认，或改到
D:\Dev\nodejs。 - 自定义页面请保持默认勾选（含 npm、Add to PATH、必要工具）。
- 若出现「Automatically install the necessary tools」（原生模块编译工具），可勾选，按提示装完。
- Install → Finish。
- 新开 CMD：
node -v、npm -v，有版本号即成功。
提示：Vue3 + Vite 建议 Node 18/20；部分老项目要 Node 14，以项目说明为准。
2. 配置 npm 国内镜像（强烈建议）
在 CMD 执行：
npm config set registry https://registry.npmmirror.com npm config get registry
第二条应打印 npmmirror 地址。之后 npm install 会快很多。
3. 前端项目：npm install 与启动
- 用 VS Code 或 IDEA 打开前端目录（有
package.json）。 - 终端进入该目录，执行
npm install（首次几分钟属正常）。 - 再执行
npm run dev或npm run serve（看 package.json 的 scripts）。 - 浏览器打开终端提示的地址（如
http://localhost:5173）。 - 接口 404 / 跨域：先启动后端，再检查 vite.config 代理或 Vue 的 devServer.proxy。
依赖坏了可重置：删掉 node_modules 和 lock 文件后重新 npm install。