# 前端运行说明

## 前置要求
- Node.js 16.x 或更高版本（已安装 v20.15.1 ✅）
- npm 或 yarn 包管理器

## 运行步骤

### 1. 进入前端目录
```bash
cd admin-frontend
```

### 2. 安装依赖
```bash
npm install
```
或使用国内镜像（如果下载慢）：
```bash
npm install --registry=https://registry.npmmirror.com
```

### 3. 启动开发服务器
```bash
npm run dev
```

### 4. 访问前端
启动成功后，在浏览器中访问：
```
http://localhost:3000
```

## 其他命令

### 构建生产版本
```bash
npm run build
```
构建后的文件会在 `dist` 目录中。

### 预览生产构建
```bash
npm run preview
```

## 注意事项

1. **确保后端服务已启动**：前端需要通过代理访问后端 API（http://localhost:8080）
2. **首次登录**：需要先通过后端接口注册管理员账号，或直接在数据库中插入管理员用户
3. **跨域问题**：后端已配置跨域支持，前端可以直接访问

## 常见问题

### 问题1：npm install 失败
**解决方案**：
- 使用国内镜像：`npm install --registry=https://registry.npmmirror.com`
- 或使用 yarn：`yarn install`

### 问题2：端口被占用
**解决方案**：
- 修改 `vite.config.js` 中的 `server.port` 为其他端口

### 问题3：无法连接后端
**解决方案**：
- 检查后端服务是否在 8080 端口运行
- 检查 `vite.config.js` 中的代理配置