预见猿份
×

欢迎来到预见猿份,本站项目均为站长原创，学习中有问题可直接提交给站长老苗解决（微信:mrt_0607）。

苗润土老师，20余年一线项目经验，2014年加入黑马，星辰wms、云岚到家、学成在线项目作者，历任高级讲师、教学主管及课程研究员。 b站老苗

系统安装与配置

配置要求 ​

工欲善其事必先利其器。

个人电脑内存至少24G以上（为了更好的学习最好升级到32G）不符合条件的同学趁休息日升级电脑。

有条件的购买便携显示器进行分屏开发，开发效率杠杠滴，这是专业程序员的标配。

下载创新wms课程资料，按照本文档要求安装配置开发环境。

免费获取课程资料方法：

关注 预见猿份 公众号，回复：wms 获取下载链接

在安装配置前关闭自己电脑的防火墙。

运行安装文件时要以管理员模式运行。

1 开发工具版本 ​

开发工具列表：

开发环境：windows 10/11

xml
开发工具	            版本号
IntelliJ-IDEA	    2022.x以上版本
JDK		            17.x
Maven		        3.6.x以上版本
Git		            2.37.x
MySQL		        8.0.x
Redis		        6.2.7
Apifox 		        2.7.x以上
influxdb	        2-2.7.12-windows
emqx		        5.3.2-windows-amd64
RabbitMQ	        3.9.17
JeecgBoot	        3.8.1

2 配置数据库环境 ​

2.1 安装MySQL ​

在windows安装MySQL，已安装无需重复安装。

安装过程请自行AI。

MySQL8安装完成并注册为服务。

通过系统服务启动停止 MySQL

2.2 使用MySQL客户端连接数据库。 ​

下边使用DataGrip 客户端连接数据库。

客户端工具不作限制，讲义中使用的是DataGrip ，安装程序从课程资料获取（datagrip-2022.2.2.win.zip）。

首先创建数据源

填写数据源的账号和密码。

点击"Test Connection" 测试成功

3 配置Redis环境 ​

3.1 安装Redis ​

在windos安装Redis，并将Redis注册为windows服务，已安装无需重复安装。

Redis命令速查：https://yjoffer.com/tools/redis-cheatsheet.html

3.2 使用客户端连接Redis ​

使用redis客户端程序 resp-2022.4.2.0.0.exe 连接redis。

客户端工具不作限制，讲义中使用的是resp-2022.4.2.0.0.exe，可从软件工具目录获取安装程序（resp-2022.4.2.0.0.exe）。

安装成功，新建一个连接:

配置连接参数：

注意：如果redis设置了密码需要输入密码

测试连接成功如下图：

点击“确定”创建连接成功。

4 配置IDEA环境 ​

4.1 编码配置 ​

4.2 自动导包设置 ​

IDEA可以自动优化导入包，但是有多个同名的类调用不同的包，必须自己手动Alt+Enter设置，
下面可以通过设置来进行导包优化。

4.3 提示忽略大小写 ​

IDEA代码提示默认是区分大小写的，设置为提示忽略大小写，编译我们后期的开发

5 Maven环境 ​

5.1 安装Maven ​

下载maven3.8.6版本（如已安装maven无需重复下载），下载链接如下：

https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.zip

解压apache-maven-3.8.6-bin.zip到没有中文的目录下。

5.2 配置仓库 ​

1、在Maven的conf目录中1文件中配置本地仓库的地址。

在setting.xml文件中配置镜像地址。

  • 通用依赖从阿里云下载（快）
  • Jeecg 特有依赖从Jeecg 官方仓库下载（确保能找到）
XML
<mirrors>
  <mirror>
     <id>alimaven</id>
          <mirrorOf>*,!jeecg,!jeecg-snapshots,!getui-nexus,central,jcenter,!2505027-release-XiIQt8,!2505027-snapshot-MApAmB</mirrorOf>
     <name>aliyun maven</name>
     <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
   </mirror>
</mirrors>

效果如下：

5.3 IDEA中配置maven ​

在IDEA中配置maven：进入 File --> Settings --> Build --> Build Tools --> Maven

配置maven安装目录、setting.xml及本地仓库的位置。

在新建项目时采用以上配置，如下图：

6 配置Git环境 ​

Git命令速查：https://yjoffer.com/tools/git-cheatsheet.html

6.1 安装Git ​

在个人电脑安装Git，已安装无需重复安装。

也可以自行下载，地址：https://git-scm.com/ （windows版本：https://git-scm.com/download/win）

安装成功，在右键菜单出现Git菜单，如下图

配置git邮箱：

Java
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

6.2 IDEA中配置Git ​

安装成功在IDEA中配置git的安装目录

7 拉取项目工程 ​

7.1 拉取后端工程 ​

工程git仓库地址：https://gitee.com/miaoruntu/chuangxin-wms-java-course.git

大家需要登录自己gitee账号，Fork该仓库到自己的空间，Fork是将其它仓库的内容复制到自己仓库。

然后选择目标空间进行复制

Fork成功，此时chuangxin-wms-java-course 工程已复制到自己的仓库中

点击“克隆/下载”，复制仓库地址

进入代码目录，执行git命令：

克隆成功：

使用IDEA打开 目录“chuangxin-wms-java-course”

在弹出窗口选择信任该项目。

打开克隆成功的工程如下图：

如果发现pom.xml的图标非上图所示，说明idea无法识别maven工程，此时需要手动操作，找到父工程的pom.xml，右键点击“Add as Maven Project”

注意配置工程使用的jdk

刷新pom.xml下载依赖

下载依赖进度可通过下边观察：

未下载完成依赖时报红，如下：

下载完成依赖后，红线消失

7.2 拉取前端工程 ​

前端工程仓库地址：https://gitee.com/miaoruntu/chuangxin-wms-vue-course.git

参考后端工程的方法将前端工程fork到自己的空间，

fork成功后，克隆自己空间下的前端工程，并用IDEA打开，如下图：

至此，前后端两个工程都克隆成功

使用IDEA打开前端工程。

8 运行项目 ​

8.1 创建数据库 ​

从后端工程的db目录找到数据库脚本文件

首先创建数据库：chuangxinwms

再导入sql脚本

选择chuangxinwms-20260325.sql 文件并执行。

导入成功，共148张表

8.2 启动后端 ​

8.2.1 配置数据库 ​

本项目使用的是jeecg-boot框架，参考jeecg-boot的开发文档（https://help.jeecg.com/java/setup/idea/startup）配置数据库地址，修改数据库地址及数据库名称即可。

具体配置如下：

8.2.2 配置Redis ​

具体配置如下：

注意：如果你的redis设置了密码一定设置密码，否则将password项注释。

8.2.3 工程结构 ​

启动前先了解本项目的工程结构，如下：

whiteboard

父工程：约定依赖版本。

核心模块：整体项目的核心依赖、类库。

系统管理模块：包括用户管理、角色管理、菜单管理、登录等功能模块

Jeecg-system-api: 对外系统管理相关接口，供其它模块调用

jeecg-system-biz：系统管理模块业务实现，包括controller、service、mapper等。

Jeecg-system-start: 启动模块，用于启动项目

仓库管理模块：包括wms业务业务模块

其它模块：包括示例代码、AI模块

8.2.4 启动后端 ​

运行Jeecg-system-start中的启动类即可启动项目。

运行：jeecg-system-start/src/main/java/org/jeecg/JeecgSystemApplication.java

启动成功，控制台如下：

8.3 配置前端 ​

8.3.1 安装nvm ​

我们面对的前端项目很多，比如A，B两个并行开发项目，nodejs依赖版本不一致。A项目需要v14.19.1老版本，B项目需要v16.15.0新版本，需要随时切换。

我们可以使用nvm工具灵活切换node.js版本

举例如下：

nvm全英文也叫node.js version management，是一个nodejs的版本管理工具。nvm是node.js版本管理工具，为了解决node.js各种版本存在不兼容现象可以通过它可以安装和切换不同版本的node.js。

参考“nvm安装”进行安装。

安装成功，使用nvm安装node.js v24.3.0版本，在cmd下运行下边的命令

Plain
nvm install 24.3.0

安装成功在nvm的安装目录下有nvm下载的nodejs

8.3.2 编译前端工程 ​

参考：https://help.jeecg.com/ui/

jeecgboot-vue3 前端项目，采用 Vue3.0+TypeScript+Vite6+Ant-Design-Vue等新技术方案，包括二次封装组件、utils、hooks、动态菜单、权限校验、按钮级别权限控制等功能。

环境要求

  • 本地环境安装 Node.js 、npm 、pnpm
  • pnpm 要求9+ 版本以上
  • Node.js 版本建议v20.15.0，要求Node 20+ 版本以上

( 因为Vite6 需要 Node.js 18 / 20+ )

cmd进入前端工程目录：

node版本切换到24.3.0，如下图：

如果没有20.18.1版本则需要通过nvm安装24.3.0版本的node，运行下的命令：

nvm install ``24.3.0

安装完成运行：nvm use 24.3.0 切换node版本。

  • 全局安装pnpm
JavaScript
npm install -g pnpm@10.26.1

如果安装pnpm失败则删除下边的文件

  • 验证pnpm版本
JavaScript
pnpm -v

如下图：

如果pnpm -v提示找不到命令说明pnpm安装失败，可以从课程资料中拷贝v24.3.0.zip，解压，将v24.3.0目录覆盖nvm下的 v24.3.0目录。

安装依赖

Plain
pnpm install

安装依赖完成：

在前端工程目录下出现：node_modules 目录

8.3.3 配置接口地址 ​

配置文件：.env.development

下边代码中http://localhost:8080/jeecg-boot表示后端地址，默认无需改变，如果后端地址发生变化则需要更改。

8.3.4 运行项目 ​

运行前端：

进入前端工程：

Plain
pnpm dev

启动成功如下图：

访问: http://localhost:3100/

进入登录页面：

账号：admin

密码：123456

登录系统，首页如下：

可以切换到菜单管理：

页面正常显示说明前后端项目启动成功。