快速开始

使用该项目前，你需要检查你本地的开发环境，避免出现问题

所需环境

这里列出项目所需的环境与相关安装教程，方便刚入门的同学

  1. 1、JDK：1.8+ 
  2. 安装教程：https://www.runoob.com/java/java-environment-setup.html
  3. 2、Redis 3.0+
  4. 安装教程：https://www.runoob.com/redis/redis-install.html
  5. 3、Maven 3.0+
  6. 安装教程：https://www.runoob.com/maven/maven-setup.html
  7. 4、MYSQL 5.5.0+
  8. 安装教程：https://www.runoob.com/mysql/mysql-install.html
  9. 5、Node v10+
  10. 安装教程：https://www.runoob.com/nodejs/nodejs-install-setup.html

TIP

前端安装完 node 后，最好设置下淘宝的镜像源，不建议使用 cnpm（可能会出现奇怪的问题）

  1. npm config set registry https://registry.npm.taobao.org
  2. 配置后可通过下面方式来验证是否成功
  3. npm config get registry
  5. 在 ~/.npmrc 加入下面内容，可以避免安装 node-sass 失败
  6. sass_binary_site=https://npm.taobao.org/mirrors/node-sass/
  8. .npmrc 文件位于
  9. win：C:\Users\[你的账户名称]\.npmrc
  10. linux：直接使用 vi ~/.npmrc

开发准备

TIP

在使用该系统前，你还需要做如下准备

1、给 idea快速开始 - 图1 或者 eclipse快速开始 - 图2 安装 lombok 插件，我们用它可以省略get，set 方法，可以使代码更简洁， 具体查看 lombok教程快速开始 - 图3

2、了解MapStruct，项目用到了他映射实体，如果你不熟悉可以查看：熟悉MapStruct快速开始 - 图4

3、你需要有 Spring boot 的基础，推荐教程 Spring Boot 2.0 学习快速开始 - 图5

4、你还需要有 Vue快速开始 - 图6 的基础，推荐入门视屏教程 网易云课堂快速开始 - 图7

运行项目

TIP

因为本项目是前后端分离的，所以需要前后端都启动好，才能进行访问

后端运行[Idea]

打开Idea，直接导入Git项目

快速开始 - 图8

输入我们的 Git 地址

  1. https://gitee.com/elunez/eladmin.git

快速开始 - 图9

打开数据库，创建一个新库 eladmin，导入sql文件夹中的初始化脚本库脚本 eladmin.sql

快速开始 - 图10

修改配置，如果你的数据库密码不是 123456，那么需要在 dev.yml 配置文件中做相应的修改

快速开始 - 图11

运行项目：找到 eladmin-system 模块中的 AppRun，点击启动按钮启动程序

快速开始 - 图12

后端运行[Eclipse]

首先克隆项目到本地，Mac 使用终端、Windows 使用 Cmd，定位到工作的目录

  1. git clone https://gitee.com/elunez/eladmin.git

快速开始 - 图13

打开Eclipse，工作空间设置为该目录

快速开始 - 图14

导入我们的的项目 File -> Import

快速开始 - 图15

选择 Maven ，然后 Next

快速开始 - 图16

选择项目的目录，然后 Finish

快速开始 - 图17

如果项目一片红色，那么需要你给 Eclipse 安装 Lombok 插件快速开始 - 图18，正常的导入后如下

快速开始 - 图19

解决 Lombok 的问题后，进入 eladmin-system 模块中的 AppRun，点击启动按钮启动程序

快速开始 - 图20

这时会有一个新的问题，那就是 mapstruct 的实现类不会自动生成，报错如下

快速开始 - 图21

解决办法就是给 Eclipse 装上 m2e-apt 插件，官方介绍快速开始 - 图22

点击 help —> install new software —> add，在location里面输入地址：

  1. http://download.eclipse.org/technology/m2e/releases

快速开始 - 图23

然后在项目根目录的 pom.xml 中的 节点中加入，然后保存

  1. <m2e.apt.activation>jdt_apt</m2e.apt.activation>

快速开始 - 图24

导入数据库，修改数据库配置，这个步骤参考上面 Idea 教程的步骤

快速开始 - 图25

点击启动按钮旁边的小按钮，然后选择 Maven Install 生成 mapstruct 的实现类

快速开始 - 图26

查看 target -> generated-sources 目录是否生成了 mapstruct 的实现类

快速开始 - 图27

这个时候启动项目，就不会报错了，至此教程结束

快速开始 - 图28

Eclipse 初次使用，因此此教程仅供参考，如果有更好的方案，可以编辑此页面，提个 Pr ！

前端运行[WebStorm]

首先克隆项目到本地，Mac 使用终端、Windows 使用 Cmd，定位到工作的目录

  1. git clone https://gitee.com/elunez/eladmin-web.git

快速开始 - 图29

打开 WebStorm，导入我们的项目

快速开始 - 图30

这个时候 WebStorm 会在右下角提示我们安装依赖

快速开始 - 图31

也可以手动在 Terminal 中输入 npm install 进行安装

快速开始 - 图32

依赖安装完成后，打开 package.json 找到 dev 旁边的启动按钮

快速开始 - 图33

启动完后打开 localhost:8013 即可

前端运行常见问题

1、依赖安装失败

可通过配置淘宝的镜像源解决

  1. npm config set registry https://registry.npm.taobao.org
  2. 配置后可通过下面方式来验证是否成功
  3. npm config get registry
  5. 在 ~/.npmrc 加入下面内容，可以避免安装 node-sass 失败
  6. sass_binary_site=https://npm.taobao.org/mirrors/node-sass/
  8. .npmrc 文件位于
  9. win：C:\Users\[你的账户名称]\.npmrc
  10. linux：直接使用 vi ~/.npmrc

2、linux 系统在安装依赖的时候会出现 node-sass 无法安装的问题

解决方案：

  1. 1. 单独安装：npm install --unsafe-perm node-sass 
  2. 2. 直接使用：npm install --unsafe-perm