Jeecg-P3 開發環境搭建全流程圖文教程：從數據庫初始化到插件集成與代碼生成器使用

Jeecg-P3 開發環境搭建全流程圖文教程：從數據庫初始化到插件集成與代碼生成器使用

項目結構速覽

jeecg-p3-parent
├── jeecg-p3-web          # 主啟動工程 (WAR)
├── jeecg-p3-biz-demo     # 演示插件 (JAR)
└── ... 其他業務插件

第一階段：數據庫初始化

1. 安裝 MySQL 5.7+，創建數據庫：

CREATE DATABASE jeecg_p3 DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

2. 導入腳本：jeecg-p3-web/doc/sql/jeecg-p3-mysql.sql

• 工具推薦：Navicat / DataGrip / MySQL Workbench。
• 關鍵：導入時選擇 UTF-8 編碼，防止中文亂碼。
• 成功後將生成核心表：t_s_user、t_s_role、t_s_menu、p3_wx_act_invite 等。

第二階段：項目導入與構建

方式一：命令行快速啟動 (推薦新手)

cd jeecg-p3-web
# Windows 雙擊運行
bin\run-tomcat7.bat
# 或 Linux/Mac
sh bin/run-tomcat7.sh

# 首次運行會下載依賴，請耐心等待
# 成功後訪問 https://localhost:8080/jeecg-p3-web/

方式二：IDE (IntelliJ IDEA / Eclipse) Maven 方式

1. File → Open → 選擇 jeecg-p3-parent/pom.xml 導入為 Maven 項目。
2. 等待依賴下載完成 (Maven 工具窗口無紅字報錯)。
3. 關鍵步驟：順序執行 install：

# 在父工程目錄
mvn clean install -DskipTests -pl jeecg-p3-biz-demo -am
# -pl 指定模塊，-am 同時構建依賴模塊
# 將插件 JAR 安裝到本地倉庫，主工程依賴才能解析

4. 配置運行配置：

• 主類：org.jeecg.web.JeecgApplication (Spring Boot) 或 Tomcat 插件 tomcat7:run。
• VM 選項：-Dfile.encoding=UTF-8。
• 勾選 Update snapshots (開發版依賴快照頻繁更新)。

5. Debug/Run 啟動，控制台出現 Started JeecgApplication in xxx seconds 即成功。

第三階段：功能驗證

• 樹形列表：https://localhost:8080/jeecg-p3-web/p3/wxActInvite.do?list
• 權限列表：https://localhost:8080/jeecg-p3-web/p3/auth.do?list
• 默認賬號：admin / 123456。

第四階段：插件集成到 Jeecg 主平台 (可選)

1. 主平台 pom.xml 添加依賴：

<dependency>
    <groupId>org.jeecg.p3</groupId>
    <artifactId>jeecg-p3-biz-demo</artifactId>
    <version>1.0.0</version>
</dependency>

2. 在主平台數據庫執行插件 SQL 腳本 (建表、菜單、字典)。
3. 後台 → 系統管理 → 菜單管理 → 新增菜單，URL 填寫插件 Controller 路徑 (如 /p3/wxActInvite.do?list)。
4. 分配角色菜單權限，重啟主平台驗證。

第五階段：代碼生成器使用

1. 配置文件：jeecg-p3-web/src/main/resources/p3-cg-config.properties

# 目標表名
table_name = p3_my_biz
# 包前綴
package_prefix = com.my.biz
# 作者
author = zhangsan
# 模板路徑 (默認即可)
template_path = p3/cg/template/ftl

2. 運行工具類：jeecg-p3-web/src/main/java/util/P3CodeGenerateUtil.java 的 main 方法。
3. 生成產出：Entity/DAO/Service/Controller/VM/JS/SQL 至指定目錄。
4. 將生成代碼複製至對應插件模塊，調整包路徑，重啟驗證。

常見問題 FAQ

目錄結構關鍵路徑速查

• 數據庫腳本：jeecg-p3-web/doc/sql/jeecg-p3-mysql.sql
• 數據源配置：jeecg-p3-web/src/main/resources/dbconfig.properties
• Velocity 模板：jeecg-p3-web/src/main/resources/vm/
• 代碼生成器模板：jeecg-p3-web/src/main/resources/p3/cg/template/ftl/
• 啟動腳本：jeecg-p3-web/bin/run-tomcat7.bat(sh)

總結

Jeecg-P3 環境搭建核心在於：數據庫 UTF-8 初始化 → Maven 依賴 install 插件 → 主工程啟動 → 菜單掛載驗證。掌握此流程，可快速啟動開發、調試插件、使用代碼生成器批量產出 CRUD 代碼，體驗「插件化、輕量、高效」的開發模式。