我开源的 waynboot-mall 项目之本地开发指南
这篇文章给大家带来我自己写的开源项目【wayn商城】的本地开发指南，帮助各位朋友在本地快速运行【wayn商城】，避免踩坑，减少不必要的精力在软件下载安装上。
🔥waynboot-mall 是一套全部开源的 H5 商城项目，实现了一套完整的商城前后台业务，有首页展示、商品分类、商品详情、sku 详情、商品搜索、加入购物车、结算下单、支付宝/微信支付、订单列表、商品评论等一系列功能 🔥。
技术上基于最新得 Spring Boot3.1、Mybatis Plus、Spring Security，整合了 Mysql、Redis、RabbitMQ、ElasticSearch 等常用中间件，根据我多年线上项目实战经验总结开发而来不断优化、完善。
前置准备
后端安装
- Jdk17，安装包下载地址 download.oracle.com/java/17/arc…
- Maven，压缩包下载地址 dlcdn.apache.org/maven/maven…
- IDE 工具，推荐使用 IntelliJ IDEA ，官网下载地址 www.jetbrains.com/idea/
- 本地数据库 MySql，安装教程 bbs.huaweicloud.com/blogs/32690…
- 本地缓存 Redis，安装教程 www.cnblogs.com/yyee/p/1583…
- MySql 客户端，推荐使用 Navicat Premium16，安装教程 learnku.com/articles/67…
- Redis 客户端，推荐使用 AnotherRedisDesktopManager，下载地址 github.com/qishibo/Ano…
- Elasticsearch7，官网下载地址 www.elastic.co/cn/download…
- Git，官网下载地址 git-scm.com/download/wi…
- 商城图片压缩包下载，在我的公众号【程序员 wayn】，回复 wayn 商城资料 领取。
前端安装
- nodejs v16.20.1 版本，安装包下载地址 nodejs.org/download/re…
- IDE 工具，推荐使用 vscode，官网地址 code.visualstudio.com/
以上软件安装包我已经下载好放在百度云盘中，大家可以在我的公众号【程序员 wayn】，回复 wayn 商城资料 即可领取。
商城图片压缩包也放在了百度云中。
本地启动前后端项目
启动前后端项目前，默认大家已经将上述软件全部安装启动成功。
后端项目
克隆 waynboot-mall 项目
- git 地址：git clone git@github.com:wayn111/waynboot-mall.git
- gitee 地址：git clone git@gitee.com:wayn111/waynboot-mall.git
导入项目依赖
将 waynboot-mall 目录用 idea 打开，导入 maven 依赖
导入 sql 文件
在项目根目录下，找到wayn_shop_*.sql文件，新建 mysql 数据库 wayn_shop，编码选择 utf8mb4，导入其中
图片部署
将商城图片压缩包中所有图片解压缩部署到 D:\waynshop\webp 目录下
修改 Mysql、Redis、RabbitMQ、Elasticsearch 连接配置
找到 waynboot-common 模块下的 application-dev.yml 文件以及 waynboot-consumer 模块下的 application.yml 文件，修改 MySQL、Redis、RabbitMQ、Elasticsearch 的连接配置相关信息
启动项目
- 后台 api 启动：进入 waynboot-admin-api 子模块，找到 AdminApplication 文件，右键
run AdminApplication，启动后台项目 - 消费者启动：进入 waynboot-message-consumer 子模块，找到 MessageApplication 文件，右键
run MessageApplication，启动消费者 - h5 商城 api 启动：进入 waynboot-mobile-api 子模块，找到 MobileApplication 文件，右键
run MobileApplication，启动 h5 商城项目
前端项目
克隆商城前台项目
- git 地址：git clone git@github.com:wayn111/waynboot-mobile.git
- gitee 地址：git clone git@gitee.com:wayn111/waynboot-mobile.git
进入项目目录
cd waynboot-mobile
安装依赖
npm install
建议不要直接使用 cnpm 安装依赖，会有各种诡异的 bug。可以通过如下操作解决 npm 下载速度慢的问题
npm install --registry=registry.npm.taobao.org
启动服务
npm run dev
克隆商城后台项目
- git 地址：git clone git@github.com:wayn111/waynboot-admin.git
- gitee 地址：git clone git@gitee.com:wayn111/waynboot-admin.git
进入项目目录
cd waynboot-admin
安装依赖
npm install
建议不要直接使用 cnpm 安装依赖，会有各种诡异的 bug。可以通过如下操作解决 npm 下载速度慢的问题
npm install --registry=registry.npm.taobao.org
启动服务
npm run dev
最后聊两句
【wayn商城】项目我打算出一个实战教学专栏，包括系统设计、本地开发指南、技术选型、基础设施、模块划分、服务器部署、日志以及监控系统集成等内容。
想要获取 waynboot-mall 项目地址以及配套资料的朋友可以在我的公众号【程序员wayn】回复 "wayn商城教学"，即可获取。