从零开始在windows环境部署运行java若依（ruoyi）框架

---

前言

对于任何一个想要自学编程的人来说，没有经验，没有明确的指导是最大的问题，各种官方的文档看的稀里糊涂，本以为复制粘贴到本机就能万事大吉，结果上手操作之后迎来的却是各种各样的红色bug，让人心态大崩，世界上没有完美的程序，也没有完美的人，学习的路上也总是会布满bug，我们都是走在先驱者走过的路上，按图索骥，一点点的变得强大，在此，我与诸位共勉！

---

一、若依是什么？

这里引用作者的介绍：若依是一套全部开源的快速开发平台，毫无保留给个人及企业免费使用。
简单来说，若依是一套简装房，里面架构好了大部分通用的后台管理系统的功能，我们可以借助这个框架，结合自己想要开发的功能，实现自己的“精装房”。
在开始之前，我默认大家有一定基础：安装了nodejs，git，idea,vscode，mysql等所需工具，并且熟悉基本操作。

二、克隆项目，启动前端

1.克隆项目

使用git是程序员必备技能，gitee地址如下：链接: ruoyi-vue，克隆到本地文件夹，第一步就算成功了.
ps:别放到带中文字的文件目录！

2.启动前端项目

01.版本检查

1.检查一下nodejs的版本是不是符合若依的要求，不能低于12，也不能高于18，因为有个别依赖不兼容，笔者用的是16.15.0版本：

node --version

或者

C:\Users\盒子狗>nvm ls

    18.1.0
  * 16.15.0 (Currently using 64-bit executable)
    14.21.3
    12.22.12
    10.16.3

题外话：笔者用的nvm是什么？
nvm是一款可以管理和切换nodejs版本的工具，感兴趣的同学可以搜索了解，顺便说一下nvm切换版本后的坑点：比如你在12版本下载了yarn依赖，但是你切换到16版本就会不见，要重新下载所有依赖，还有就是切换版本要使用管理员权限，不然会失败

02.安装依赖

前端项目是文件夹ruoyi-ui,我们用vscode打开这个项目，然后用经典操作ctrl+shift+y调出vscode的命令行，切换到终端

然后就是99%的新手都会遇上的问题--npm依赖下载很慢怎么办？

我们先设置一个国内镜像仓库：

npm config set registry https://registry.npmmirror.com/

然后就可以安装项目所需的前端依赖了：

npm install

如果执行没问题，就可以启动前端项目了，这里注意一下端口占用问题就行了：

npm run dev

到这里前端项目启动就算完成了。

三、数据库搭建

若依的数据库搭建比较简单，共有2个sql文件，笔者使用的是mysql8.0,使用mysql Command Line Client执行一下导入命令（不是mysql shell）,如果碰到了中文乱码的问题，我写在另一篇博客：mysql导入数据出现中文乱码

四、启动若依后台

1.dependency依赖问题

可以这么说，99%的人拉取一个不熟悉的项目后都会出现启动问题，其中90%的问题都出在依赖版本不兼容上，不管是学习还是工作上，你能让依赖下载完成并且兼容，你就已经成功了启动了这个项目的50%了。兼容性作为软件开发的世纪难题之一，新手和老鸟的区别在于，新手会懵逼放弃，老鸟知道从哪开始解决。

兼容性原则第一条，只引入，不修改

面对你完全不熟悉的项目时，你最好不要修改它的pom文件里的依赖版本，因为你不知道他用了什么特性，你可以试试把

<artifactId>spring-boot-dependencies</artifactId>
                <version>2.5.15</version>

改成2.2.x版本，本来能运行的项目立马跑不起来，而且还很难找出是什么bug。

下面讲一下怎么解决一些常见的maven依赖拉取问题：
1.依赖拉取慢怎么解决？
依赖下载慢最通用的方式就是修改setting.xml文件，换一个中国镜像源，因为maven的官网在国外，第二种就是科学上网，镜像源修改网上有很多，这里我就不多赘述。
2.idea在哪里里配置maven
具体如下，file -->settings,然后settings里面

3.怎么修改jdk版本
很多依赖版本跟jdk版本也是挂钩的，有时候我们要切换jdk版本就在这里切换：
file -> project structure
2和3的修改都需要apply,别修改完就关闭窗口了

2.修改配置文件application-druid.yml

主要修改的是这个文件这几项配置，改成自己本地数据库的配置，这个文件在ruoyi-admin 的resource文件夹下面。

>druid:
            # 主库数据源
            master:
                url: jdbc:mysql://localhost:3306/ruoyi?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
                username: root
                password: root

3.比较特别的修改

这里我修改了一个方法的名称，在ruoyi-framework这个包里，展开config包，里面有个i18nconfig的类，把原来的
public LocaleResolver localeResolver()换成了
public LocaleResolver customLocaleResolver()
这个问题也早有人在gitee的issue上跟作者提过，原方法名会跟一个依赖包的方法重名，导致程序运行不起来，作者给出了另一种修改方法，这里我是觉得这个类没有其他引用，直接换了个方法名字。

最后，启动redis服务，然后run起来！

---

总结

这些是我在启动项目时解决的一些问题，希望能帮到你积累一些经验，若我有错误疏漏请私信我修改，你我都是走在先驱者路上的一份子。