### 🚀 启动 Web.Vue.Demo

本项目是一个基于 **Vue** 的前端工程，请按照以下步骤在本地启动开发环境：

#### 1. 检查 Node.js 环境
在命令行工具（Terminal/CMD）中执行以下命令，确认是否已安装 Node.js：

```bash
node -v
# 或者仅输入 node 后回车
```

- ✅ **已安装**：若返回版本号（如 `v18.16.0`）或 `Welcome to Node.js` 等信息，说明环境就绪。
- ❌ **未安装**：若无响应或提示命令不存在，请先前往 [Node.js 官网](https://nodejs.org/) 下载并安装最新 LTS 版本。

#### 2. 进入项目目录
执行以下命令进入 Vue 工程的根目录。
> 💡 **注意**：请将 `<ProjectRootPath>` 替换为您本地的实际路径。

```bash
cd <ProjectRootPath>
```

#### 3. 安装依赖
在项目根目录下执行以下命令，安装项目所需的 npm 依赖包：

```bash
npm i
```
*(注：`npm i` 是 `npm install` 的简写)*

#### 4. 启动开发服务器
执行以下命令启动项目：

```bash
npm run dev
```

#### 5. 访问应用
命令运行成功后，终端会输出本地访问地址（通常为 `http://localhost:5173` 或 `http://localhost:8080`）。
请在浏览器中打开该链接即可预览 Demo。

---

#### 💡 常见问题
- **端口占用**：如果默认端口被占用，Vite/Webpack 通常会自动尝试下一个可用端口，请留意终端输出的具体 URL。
- **依赖安装失败**：若 `npm i` 速度过慢或报错，可尝试切换淘宝镜像源：
  ```bash
  npm config set registry https://registry.npmmirror.com
  npm i
  ```