Skip to content

启动前端

确保已安装 Node.js 与 pnpm,并且后端服务已启动在 http://localhost:8580

安装依赖

bash
cd forge-admin-ui
pnpm install

配置环境变量(可选)

前端默认代理到 localhost:8580,如果你的后端地址不同,创建 .env.local 文件:

bash
# 从模板复制
cp .env.example .env.local

编辑 .env.local

env
# 后端 API 地址(开发环境通过 Vite 代理转发)
VITE_API_BASE_URL=http://localhost:8580

启动开发服务器

bash
pnpm dev

启动成功后,你会看到:

  VITE v7.x.x  ready in xxx ms

  ➜  Local:   http://localhost:3000/
  ➜  Network: use --host to expose

访问前端

在浏览器中打开 http://localhost:3000,你应该看到登录页面。

前端开发命令

命令说明
pnpm dev启动开发服务器(支持 HMR 热更新)
pnpm build生产构建
pnpm lint:fix代码检查和自动修复

代理配置说明

开发模式下,Vite 将 /api 前缀的请求代理到后端:

http://localhost:3000/api/xxx  →  http://localhost:8580/xxx

这意味着你在前端代码中请求 /api/system/user/page 时,实际请求的是 http://localhost:8580/system/user/page

下一步

继续 第一次登录

Forge Admin — 基于 Vue3 + Spring Boot 的企业级后台管理框架