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

2021 年 1 月 7 日
筆記
講解開源項目系列

本文適合有 Java 基礎並了解 SpringBoot 框架的同學

本文作者：HelloGitHub-嘉文

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

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

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

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

一、快速開始

1.1 環境準備

後端環境：

JDK 1.8+
Maven 3.0+
MYSQL 5.5+
Redis 3.0+

前端環境：

Node v10+

開發工具

IDE：IDEA
MySQL 可視化：Navicat

1.2 快速開始

（1）clone 項目

GitHub：

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

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

# 後端項目
git clone //gitee.com/elunez/eladmin.git
# 前端項目
git clone //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.1 端口佔用

報錯信息：

我們這裡使用其他端口，修改配置文件 application.yml 端口為 8001：

server:
  port: 8001

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

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

設置淘寶鏡像源來解決

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

檢查是否設置成功

npm config get registry

三、如何學習這個項目

3.1 基本用途

EL-ADMIN 是一個簡單且易上手的 Spring boot 後台管理框架，你可以通過它學習到：

Spring Boot、Spring Data JPA、JWT、Spring Security、Redis、Vue、Element-UI 等框架的使用
增加項目經驗
學習代碼規範
作為接私活開發的「腳手架」，提高賺錢效率（比如項目代碼生成模塊可以直接生成前後端代碼）

3.2 深入學習

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

了解技術框架：如果你沒有了解 Spring Boot、Spring Data JPA、JWT、Spring Security、Redis、Vue、Element-UI 這些技術框架你應該先去了解它們，這是項目基石，不會的請網上搜索，因為 搜索是基本技能
了解項目結構：了解各個模塊和文件的主要作用
了解項目功能：了解項目實現的功能（比如說權限驗證），這個項目使用了什麼技術來實現「權限驗證」（JWT 和 Spring Security），你需要在源代碼裏面將這個功能實現的大致流程看懂（你可以找到功能入口一層一層點進去或者 Debug 或者自己寫一個類似功能）

3.3 怎麼學習

學習一個開源項目，你應該首先要明確的是 你學習開源項目的目的，因為很多開源項目（比如 EL-ADMIN）代碼量還是比較大的，不同學習目的應該有不同的學習深度，而不是僅限於快速開始然後無從下手。

四、最後

很多同學學習 SpringBoot 的相關課程之後並不知道應該繼續學習什麼、做些什麼實戰項目。因為我就有類似的經歷，這裡我的個人建議：學習不是目的，使用起來才是，學了就要用，學了卻不去用，還不如不學，因為不久就會忘的一乾二淨。如果只是學習卻不鞏固你的大腦就會將其忘記，而「實踐」就是鞏固的最佳方法，希望你能在實踐中體驗設計程序的快樂！

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

如果你有感興趣的開源項目，但是不知道怎麼上手，歡迎留言告訴我們。《講解開源項目系列》就是幫助大家快速上手開源項目，所以你的需求就是我們的使命～留言吧！

五、參考

Tags: 講解開源項目系列