前端运行说明

前置要求

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

运行步骤

1. 进入前端目录

cd admin-frontend

2. 安装依赖

npm install

或使用国内镜像（如果下载慢）：

npm install --registry=https://registry.npmmirror.com

3. 启动开发服务器

npm run dev

4. 访问前端

启动成功后，在浏览器中访问：

http://localhost:3000

其他命令

构建生产版本

npm run build

构建后的文件会在 dist 目录中。

预览生产构建

npm run preview

注意事项

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

常见问题

问题1：npm install 失败

解决方案：

使用国内镜像：npm install --registry=https://registry.npmmirror.com
或使用 yarn：yarn install

问题2：端口被占用

解决方案：

修改 vite.config.js 中的 server.port 为其他端口

问题3：无法连接后端

解决方案：

检查后端服务是否在 8080 端口运行
检查 vite.config.js 中的代理配置