mall-admin 是一个基于 vue3-element-admin 升级的 Vue3 版本的商城管理前端工程。它采用了主流的前端技术栈包括 Vue3、Vite3、TypeScript、Vue Router、Pinia、Volar 和 Element Plus 等,以实现一套完整的商城管理系统。
1. 项目优势
简单易上手
mall-admin 基于 vue-element-admin 进行升级,对于已经熟悉该框架的开发者来说,极易上手并降低了学习成本。
实际接口支持
与许多其他前端工程不同的是,mall-admin 提供了完整适配的微服务权限系统线上接口,这意味着它可以直接应用于真实的企业级前后端接入场景,而非仅仅使用 Mock 数据。
功能全面
mall-admin 提供了丰富的功能,包括国际化、动态路由、按钮权限控制、主题大小切换、Echarts 图表和 wangEditor 富文本编辑器等。
完善的 TypeScript 支持
mall-admin 对 TypeScript 的支持非常全面,无论是组件还是 API 调用层面,都提供了完整的 TypeScript 类型支持。
主流 Vue3 生态和前端技术栈
mall-admin 借助 Vue3 生态和常用前端技术栈,对一些常用组件进行了简洁封装,使开发更加高效。
全面的项目文档支持
如果你是从零开始使用该项目,mall-admin 提供了全面的项目文档支持,帮助你快速上手并了解项目的各项功能和配置。
全栈技术支持
除了提供微服务接口和 Vue3 管理前端,mall-admin 还支持 uni-app 移动端和 K8S 持续集成交付等全栈技术应用。
2. 技术栈
- Vue3:渐进式 JavaScript 框架。
- TypeScript:JavaScript 的一个超集,提供了静态类型检查以增强代码的可读性和可维护性。
- Vite:快速的前端开发与构建工具,提供了快速的冷启动、热模块替换和按需编译等特性。
- Element Plus:基于 Vue 3 的组件库,为开发者和设计师提供了丰富的 UI 组件。
- Pinia:新一代的状态管理工具,提供了更好的类型推导和开发体验。
- Vue Router:Vue.js 的官方路由管理器,用于实现前端路由功能。
3. 环境准备
在开始使用 mall-admin 之前,需要进行一些环境准备。
安装 Node.js
请确保你已经安装了 Node.js,并且版本在 16+。
开发工具
推荐使用 VSCode 作为开发工具,并安装以下必要插件:
- Vue Language Features (Volar):提供 Vue 语言支持。
- TypeScript Vue Plugin (Volar):提供 TypeScript 支持。
4. 项目启动
在开始开发之前,有两种情况需要注意:
- 如果后端接口尚未启动或者本地没有部署后端接口,需要修改 vite.config.ts 文件中的代理地址为 http://localhost:9999,以便与后端进行通信。
- 在开始前,请先执行 npm install 命令,安装所需的依赖。
启动项目的命令如下:
npm run dev
5. 项目部署
在完成开发并进行测试之后,你可能希望将 mall-admin 部署到生产环境中。下面是一些关于项目部署的指南。
本地打包
首先,你需要执行以下命令对项目进行打包:
npm run build:prod
该命令会生成一个名为 dist 的文件夹,其中包含了所有打包后的静态文件。
Nginx 配置
接下来,我们需要配置 Nginx 以便将静态文件正确地提供给客户端。假设你已经安装好了 Nginx,并拥有一个服务器配置文件(通常是位于 /etc/nginx/nginx.conf 或 /etc/nginx/sites-available 目录下)。
请将以下代码添加到你的 Nginx 服务器配置文件中,用于配置代理和路由转发:
server {
listen 80;
server_name localhost;
location / {
root /usr/share/nginx/html/web;
index index.html index.htm;
}
# 代理转发请求至网关,prod-api标识解决跨域问题
location /prod-api/ {
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass https://api.youlai.tech/;
}
}
请根据你的实际情况修改 listen、server_name 和 root 等配置项。
启动 Nginx
完成配置后,使用以下命令启动 Nginx 服务:
sudo service nginx start
访问项目
现在,你可以通过浏览器访问以下地址来查看部署后的 mall-admin 项目:
http://localhost:9527
请确保该地址与你在 Nginx 配置文件中设置的 server_name 一致。
结语
通过本文,我们介绍了 mall-admin 商城管理前端工程的特点、技术栈以及环境准备和部署过程。希望这篇文章对你理解和使用 mall-admin 有所帮助。如果你对该项目有更多的疑问或需求,请参考官方文档或咨询开发者。祝你在商城管理前端开发中取得成功!