不想加班開發管理後臺了，試試這個 Java 開源項目吧！

本文適合有 Java 基礎並瞭解 SpringBoot 框架的同窗

本文做者：HelloGitHub-嘉文

這裏是 HelloGitHub 推出的《講解開源項目》系列，今天給你們帶來一款開源的 Java 後臺管理框架——EL-ADMIN

它是一個基於 Spring Boot、Spring Data JPA、JWT、Spring Security、Redis、Vue、Element-UI 的先後端分離的後臺管理系統。若是你想要學習上面這些框架的使用、增長實戰經驗、學習代碼規範，又或者找接私活開發的腳手架，提升賺錢的效率，EL-ADMIN 都能知足你的需求。

項目地址：https://github.com/elunez/eladmin

簡單配置後可直接運行，極大地提升了你在開發管理後臺的效率，從而有更多時間逛 HelloGitHub。不信？跟着本文，讓你 5 分鐘 跑起來一個功能豐富的管理後臺項目。

1、快速開始

1.1 環境準備

後端環境：

1. JDK 1.8+
2. Maven 3.0+
3. MYSQL 5.5+
4. Redis 3.0+

前端環境：

1. Node v10+

開發工具

1. IDE：IDEA
2. MySQL 可視化：Navicat

1.2 快速開始

（1）clone 項目

• GitHub：

# 後端項目
git clone https://github.com/elunez/eladmin.git
# 前端項目
git clone https://github.com/elunez/eladmin-web.git

• Gitee（國內訪問網速較快）：

# 後端項目
git clone https://gitee.com/elunez/eladmin.git
# 前端項目
git clone https://gitee.com/elunez/eladmin-web.git

（2）導入 MySQL 數據庫

打開 Navicat，鏈接 MySQL，新建數據庫 eladmin，設置字符集和排序規則以下圖所示：

右鍵你新建的數據庫，選擇「運行 SQL 文件」，選擇 clone 的下來的 eladmin/sql/eladmin.sql 文件。

導入 SQL 數據成功，一共有 27 張表。

（3）運行後端項目

配置文件：使用 IDEA 打開後端項目 eladmin，等待 maven 下載結束後，打開配置文件 yml 配置數據庫，改爲你機器上的 MySQL 或者 Redis 的 IP、端口和密碼。

MySQL 默認：

• url：localhost:3306
• 密碼：123456

Redis 默認：

• url：localhost:6379
• 密碼：無

運行後端項目：

（4）運行前端項目

在 clone 的前端項目「eladmin-web」文件夾下打開 cmd 命令行窗口。

# 安裝
npm install
# 運行 
npm run dev

1.3 效果預覽

運行成功會自動彈出下面界面：

2、可能遇到的坑

2.1 端口占用

報錯信息：

咱們這裏使用其餘端口，修改配置文件 application.yml 端口爲 8001：

server:
  port: 8001

注意：修改後端端口後，須要修改前端對應的請求接口。

2.2 npm install 安裝緩慢或者安裝失敗

設置淘寶鏡像源來解決

npm config set registry https://registry.npm.taobao.org

檢查是否設置成功

npm config get registry

3、如何學習這個項目

3.1 基本用途

EL-ADMIN 是一個簡單且易上手的 Spring boot 後臺管理框架，你能夠經過它學習到：

• Spring Boot、Spring Data JPA、JWT、Spring Security、Redis、Vue、Element-UI 等框架的使用
• 增長項目經驗
• 學習代碼規範
• 做爲接私活開發的「腳手架」，提升賺錢效率（好比 項目代碼生成模塊 能夠直接生成先後端代碼）

3.2 深刻學習

瞭解完基本用途和快速開始以後，你想要更深層的學習這個開源項目的話，能夠：

1. 瞭解技術框架：若是你沒有了解 Spring Boot、Spring Data JPA、JWT、Spring Security、Redis、Vue、Element-UI 這些技術框架你應該先去了解它們，這是項目基石，不會的請網上搜索，由於 搜索是基本技能
2. 瞭解項目結構：瞭解各個模塊和文件的主要做用
3. 瞭解項目功能：瞭解項目實現的功能（好比說 權限驗證 ），這個項目使用了什麼技術來實現「權限驗證」（JWT 和 Spring Security），你須要在源代碼裏面將這個功能實現的大體流程看懂（你能夠找到功能入口一層一層點進去或者 Debug 或者 本身寫一個相似功能）

3.3 怎麼學習

學習一個開源項目，你應該首先要明確的是 你學習開源項目的目的，由於不少開源項目（好比 EL-ADMIN）代碼量仍是比較大的，不一樣學習目的應該有不一樣的學習深度，而不是僅限於快速開始而後無從下手。

4、最後

不少同窗學習 SpringBoot 的相關課程以後並不知道應該繼續學習什麼、作些什麼實戰項目。由於我就有相似的經歷 ，這裏個人我的建議：學習不是目的，使用起來纔是，學了就要用，學了卻不去用，還不如不學，由於不久就會忘的一乾二淨。若是隻是學習卻不鞏固你的大腦就會將其忘記，而「實踐」就是鞏固的最佳方法，但願你能在實踐中體驗設計程序的快樂！

至此，感謝您的閱讀。項目涉及到的知識點比較多，若是你時間不夠充裕，建議選擇感興趣或者合適的功能去學習，有基礎建議直接閱讀 官方文檔。

若是你有感興趣的開源項目，可是不知道怎麼上手，歡迎留言告訴咱們。《講解開源項目系列》就是幫助你們快速上手開源項目，因此你的需求就是咱們的使命～留言吧！

5、參考

1. 官方文檔

2. 如何學習開源項目