目录

前景提示

  • 若伊是国内一款很好的开源项目,非常的便于学习,而且它是开源免费的,但是,它的开发部署文档实在是没法按照那个文档,快速高效的在本地搭建一套可以运行的项目,对于学习开发和使用实在是一大难题,为此本博主耗时一个多星期,特意编辑了这套高效,快捷合理的部署文档,希望看到的人可以快速搭建项目,快速学习,文档不全,不合理,不可复用性一直是我国开发界的弊病,看看邻国印度,就是文档写的好,都享誉硅谷了,希望我国的开发不要仅仅是技术好,文档的状况也要提上日程,毕竟可以一直让更多人开发学习的才是最好的开源软件,才能更好的做大做强.
日期 修改人 修改内容
2021年3月11日 北极的大企鹅 十三.登陆
2023年1月10日 北极的大企鹅 接口文档swagger访问

一、环境整合

构建工具(参考工具部署方式)

软件名称 版本 相关文章推荐
Git 13.5.0 https://www.cnblogs.com/liuyangfirst/p/15996063.html
NodeJS 16.0.0 https://www.cnblogs.com/liuyangfirst/p/15998172.html
JDK 1.8 https://www.cnblogs.com/liuyangfirst/p/14334385.html
Maven 3.6.0 https://www.cnblogs.com/liuyangfirst/p/15981202.html
MySQL 5.6.10 https://www.cnblogs.com/liuyangfirst/p/15997667.html
Redis 5.0.10 https://www.cnblogs.com/liuyangfirst/p/15998117.html
DBeaver 7.3.0 https://www.cnblogs.com/liuyangfirst/p/15997753.html
IntelliJ IDEA 尽量使用比较新的版本 https://www.jetbrains.com/idea/
RedisDesktopManager 0.9.3.817 https://www.cnblogs.com/liuyangfirst/p/15998132.html

官方文档

二、git 导入编译器

三、模块描述浅析

  • 文件路径:RuoYi-Vue/pom.ml
模块名称 描述
ruoyi-admin 启动模块,启动配置在resource的yml下
ruoyi-framework 主题框架模块,框架怎么运行的仔细看看,这个是核心重点
ruoyi-system 业务模块,几乎所有业务都在这里
ruoyi-quartz 定时任务模块,跑的定时任务基本都在这里
ruoyi-generator 基础公共表的操作,相当于基础表和基础业务存放位置
ruoyi-common 公共代码模块,list转set什么的一般放这里,自己不要瞎写方法,公共的都放这里

四、配置文档

名称 位置
模块 ruoyi-admin
路径 src/main/resources
综合配置 application.yml

application.yml修改

  • 这里有一个文件路径需要修改为本地的,服务器部署时再修改一次对应服务器的地址

  • 修改redis账户密码配置(redis一定要配置密码,否则的话启动的时候就会报错)

application-druid.yml修改

  • 修改MySQL账户密码配置

logback.xml修改

  • 修改logback.xml的日志存放路径

五、在IDEA中执行MySQL的脚本

  • 在本地DBeaver建立数据库ry-vue,(不建立,以下步骤操作不了)

  • 右侧栏，找到DATABASE，选择加号，找到MYSQL

  • 填写配置信息,测试连接,测试连接的时候可能要下载相关的jar包.

  • 找到需要运行的脚本,然后选择run

  • 填写数据库信息,选择右侧加号,导入刚刚配置的数据库.

  • 然后点击run,就会成功运行脚本.

  • 打开DBeaver检查数据执行成功.

六、启动后台项目

  • 保证IDE的maven配置为本地的maven,JDK为1.8以上的在项目对应上,还有编码格式没有问题(这些基础问题没有问题)

    • File -> setting
    • File -> Project Struct
    • File->Settings->Editor ->File Encodings
    • File->Settings->Build -> Compiler -> Java Compiler

  • 点击maven这里的刷新

  • 点击ruoyi的这三项加载(三个同时选中,然后点击run的绿色三角形).
    2022最新IntellJ IDEA诺依开发部署文档-小白菜博客

  • 启动redis,这里写了这样的脚本,然后把脚本的快捷方式发送到了桌面

    • 找到本地安装redis的路径

    • 新建文件redis_start.bat,写入如下脚本

  
  cd D:\ProgramFiles\Redis
  redis-server.exe redis.windows.conf
  pause

  • 选择redis_start.bat右键,发送快捷方式到桌面,就生成了快捷启动方式

  • 双击redis_start.bat启动redis

  • 项目的启动位置

  • 右键选择run执行

  • 如图所示为启动成功

七、IDEA前端配置

1、修改代码

  • 打开前端代码，找到文件vue.config.js访问配置文件保证如图位置和admin模块的端口号一致。

2、手动加载vue配置，运行前端

  • 打开编译器下边的Terminal，进入ruoyi-ui路径执行如下命令

  npm install或者 cnpm install      加载本地包

  • 由于项目的package.json里设置了编译项目的pro，所以执行如下命令


   npm run build:prod               建立项目

  • 构建成功，成功后会生成dist（相当于jar包）文件。

  • 项目启动命令,点击红色链接位置即可访问

   npm run dev                      启动项目

3、项目自带脚本启动(彩蛋)

  • 项目下有这样三个文件,就是前端启动使用的脚本(注意启动顺序)

  • 使用方式,右键,然后选择open in terminal

4、IDEA配置，运行前端

  • 找到IDE工具栏，就是启动项目的run那里

  • 点击下拉框，找到Eidt Confiuration，选择

  • 选择小加号

  • 选取npm

  • 设置npm页，完成后，点击apply

  • run npm ，如图选择run或者debug。

  • 运行成功（如果本地的npm安装没问题，就会产生如图的样子）。

注意:

问题：IDEA 2020 存在编译问题:Error:(3, 32) java: 程序包org.springframework.boot不存在。

  • 勾选:Delegate IDE build/run actions to Maven.

八、登陆

  • 以上没有问题,就会自动弹出登陆页面

  • 登陆账户问题在项目RuoYi-Vue\doc，账户／密码　：admin/admin123（文档里有）

  • 进入主页

序号 文档
1 若依环境使用手册.docx

  • 点开查看,不是所有的接口都有文档,需要可以自己添加.

  • 代码位置(com.ruoyi.web.controller.tool.TestController),可以参考为其他接口加上这三个注释

  • 加上之后的效果.

  • 在系统中查看swagger.

九、本地调试好使版

修复bug

日期 文档
2022-04-19 若依环境修复bug
2022-05-15 登陆状态已过期bug

结语

呕心沥血,爆肝一个星期（需要写配置环境的文档，还要反复测试，以便为各位看官老爷提供最好的精品文章）,希望点赞,收藏,评论,转发,您的支持就是本博主前进的动力.