Skip to content

前端开发 ​

FastBee 前端基于 Vue 2 + ElementUI 构建。

页面导读 ​

适用场景需要修改管理端页面、新增业务页面或调试接口联调的前端开发者。
前置条件已安装 Node.js 和 npm;本地联调时后端服务已在 8080 端口运行。
操作路径进入 vue 目录 → npm install → npm run dev → 浏览器访问并登录验证。
验收点开发服务正常启动,登录成功,页面接口数据正常加载;npm run build:prod 构建成功。

环境搭建 ​

前置条件:已安装 Node.js 和 npm。

bash
cd vue
npm install
npm run dev          # 开发模式
npm run build:prod   # 生产构建

依赖下载缓慢时,可切换镜像源后重试:

bash
npm config set registry https://registry.npmmirror.com

目录结构 ​

vue/src/
├── api/          # 后端 API 调用封装
├── assets/       # 静态资源
├── components/   # 公共组件
├── directive/    # 自定义指令
├── layout/       # 布局组件
├── plugins/      # 插件配置
├── router/       # 路由配置
├── store/        # Vuex 状态管理
├── utils/        # 工具函数
└── views/        # 页面视图

开发规范 ​

  • 页面文件放在 views/ 目录,按模块组织子目录
  • API 请求封装在 api/ 目录
  • 公共组件放在 components/ 目录
  • 使用 ElementUI 组件库,遵循其设计规范

代理配置 ​

开发环境通过 vue.config.js 配置代理,将 /dev-api 请求转发到后端服务:

js
proxy: {
  '/dev-api': {
    target: 'http://localhost:8080',
    changeOrigin: true,
    pathRewrite: { '^/dev-api': '' }
  }
}

验证运行 ​

  1. npm run dev 启动成功后,浏览器打开终端输出的本地地址
  2. 使用默认账号 admin / admin123 登录
  3. 打开设备管理等页面,确认接口数据正常加载(需要后端服务已在 8080 端口运行)

生产构建与部署 ​

npm run build:prod 的构建产物输出到 vue/dist 目录。部署时将目录内容复制到 Nginx 的 Web 根目录,并按系统部署中的 Nginx 配置将 /prod-api/ 代理到后端服务。

常见问题 ​

页面报 Network Error 或接口 404? ​

确认后端服务已在 8080 端口运行;开发环境检查 vue.config.js 中 /dev-api 代理的 target 是否指向后端地址。

npm install 失败或依赖下载缓慢? ​

先切换镜像源 npm config set registry https://registry.npmmirror.com 后重试;仍失败时删除 node_modules 目录重新安装。

登录后接口返回 401? ​

登录态 Token 失效或请求未携带 Token,重新登录即可;接口认证方式见 API 接口。