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

本文作者：HelloGitHub-嘉文

這裡是 HelloGitHub 推出的[《講解開源專案》](https://github.com/HelloGitHub-Team/Article)系列，今天給大家帶來一款開源的 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. 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： ```bash # 後端專案 git clone https://github.com/elunez/eladmin.git # 前端專案 git clone https://github.com/elunez/eladmin-web.git ``` - Gitee（國內訪問網速較快）： ```bash # 後端專案 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 命令列視窗。 ```bash # 安裝 npm install # 執行 npm run dev ``` ### 1.3 效果預覽 執行成功會自動彈出下面介面：  ## 二、可能遇到的坑 ### 2.1 端口占用 報錯資訊：  我們這裡使用其他埠，修改配置檔案 `application.yml` 埠為 8001： ```yaml server: port: 8001 ``` **注意：修改後端埠後，需要修改前端對應的請求介面。**  ### 2.2 `npm install` 安裝緩慢或者安裝失敗 設定淘寶映象源來解決 ```bash npm config set registry https://registry.npm.taobao.org ``` 檢查是否設定成功 ```bash npm config get registry ``` ## 三、如何學習這個專案 ### 3.1 基本用途 EL-ADMIN 是**一個簡單且易上手的 Spring boot 後臺管理框架**，你可以通過它學習到： * Spring Boot、Spring Data JPA、JWT、Spring Security、Redis、Vue、Element-UI 等框架的使用 * 增加專案經驗 * 學習程式碼規範 * 作為接私活開發的「腳手架」，提高賺錢效率（比如 [專案程式碼生成模組](https://el-admin.vip/guide/hdsc.html) 可以直接生成前後端程式碼） ### 3.2 深入學習 瞭解完**基本用途**和**快速開始**之後，你想要更深層的學習這個開源專案的話，可以： 1. 瞭解技術框架：如果你沒有了解 Spring Boot、Spring Data JPA、JWT、Spring Security、Redis、Vue、Element-UI 這些技術框架你應該先去了解它們，這是專案基石，不會的請網上搜索，因為 **搜尋是基本技能** 2. 瞭解專案結構：[瞭解各個模組和檔案的主要作用](https://el-admin.vip/guide/kslj.html) 3. 瞭解專案功能：瞭解專案實現的功能（比如說 [許可權驗證](https://el-admin.vip/guide/hdsc.html) ），這個專案使用了什麼技術來實現「許可權驗證」（JWT 和 Spring Security），你需要在原始碼裡面將這個功能實現的大致流程看懂（你可以找到功能入口一層一層點進去或者 Debug 或者 自己寫一個類似功能） ### 3.3 怎麼學習 學習一個開源專案，你應該首先要明確的是 **你學習開源專案的目的**，因為很多開源專案（比如 EL-ADMIN）程式碼量還是比較大的，不同學習目的應該有不同的學習深度，而不是僅限於快速開始然後**無從下手**。 ## 四、最後 很多同學學習 SpringBoot 的相關課程之後並不知道應該繼續學習什麼、做些什麼實戰專案。因為我就有類似的經歷 ，這裡我的個人建議：**學習不是目的，使用起來才是**，學了就要用，學了卻不去用，還不如不學，因為不久就會忘的一乾二淨。如果只是學習卻不鞏固你的大腦就會將其忘記，而「實踐」就是鞏固的最佳方法，希望你能在實踐中體驗設計程式的快樂！ 至此，感謝您的閱讀。專案涉及到的知識點比較多，如果你時間不夠充裕，建議選擇感興趣或者合適的功能去學習，有基礎建議直接閱讀 [官方文件](https://el-admin.vip/guide/)。 如果你有感興趣的開源專案，但是不知道怎麼上手，歡迎留言告訴我們。《講解開源專案系列》就是幫助大家快速上手開源專案，所以你的需求就是我們的使命～留言吧！ ## 五、參考 1. [官方文件](https://el-admin.vip/guide/) 2. [如何學習開源專案](https://www.cnblogs.com/bodhitree/p/4831504.html)