前端开发
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': '' }
}
}验证运行
npm run dev启动成功后,浏览器打开终端输出的本地地址- 使用默认账号
admin/admin123登录 - 打开设备管理等页面,确认接口数据正常加载(需要后端服务已在 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 接口。


