jeecgboot/JeecgBoot · 上手攻略

• 仓库：jeecgboot/JeecgBoot
• 链接：https://github.com/jeecgboot/JeecgBoot
• 分类：ai
• 作者：Jay
• 更新：2026-07-10

一、是什么

JeecgBoot 是一款企业级 AI 低代码平台，基于 Java（Spring Boot 2/3）和 Vue3，核心理念是"低代码 + AI"双轮驱动——用低代码提升 CRUD 开发效率，用 AI 降低使用门槛。

核心定位： - 面向企业内部的 MIS/OA/ERP 系统快速构建； - AIGC 应用开发平台：内置类 Dify 的 AI 应用编排 + 知识库问答，支持对接 DeepSeek、ChatGPT、Ollama 等多种大模型； - 半智能开发模式：零代码（Online 配置）→ 低代码（代码生成器）→ 手工 Merge，兼顾效率与灵活性。

最新稳定版：3.8.3（2025-10-09），基于 SpringBoot 2；SpringBoot 3 版本（3.x）正在主推，建议新项目直接用 SpringBoot 3 分支。

二、解决什么问题

1. Java 信息系统开发效率低 — 传统 SSM/SSH 项目重复 CRUD 代码占比 80%，JeecgBoot 用代码生成器一键生成前后端代码。
2. AI 应用开发没有统一平台 — 内置类 Dify 的 AI 应用编排、知识库管理、模型管理模块，无需从零搭 AI 能力。
3. 低代码平台不够灵活 — 采用"Online 零代码 + 代码生成低代码 + 手工 Merge"的混合模式，不被低代码平台本身限制死。
4. 信创/国产化合规需求 — 兼容达梦、人大金仓、TiDB、东方通、麒麟 OS 等国产数据库和操作系统。

三、快速安装

前提

• JDK 17+
• Maven 3.8+
• Node.js 18+
• MySQL 8.0+（或其他兼容数据库）
• Redis（可选，用于分布式 Session）

步骤 1：获取代码

# SpringBoot 3 最新版（推荐）
git clone -b springboot3 https://github.com/jeecgboot/JeecgBoot.git
cd JeecgBoot

# SpringBoot 2 老版（v3.8.3）
git clone -b master https://github.com/jeecgboot/JeecgBoot.git

步骤 2：初始化数据库

# 创建数据库（MySQL 示例）
mysql -u root -p -e "CREATE DATABASE jeecg_boot DEFAULT CHARACTER SET utf8mb4;"

# 执行初始化 SQL 脚本
mysql -u root -p jeecg_boot < jeecg-boot/db/mysql-jeecg-boot.sql

步骤 3：配置数据库连接

编辑 jeecg-boot/src/main/resources/application-dev.yml：

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/jeecg_boot?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
    username: root
    password: your_password

步骤 4：启动后端

cd jeecg-boot
mvn clean package -DskipTests
java -jar target/jeecg-boot.jar

后端默认端口：9100，管理后台地址：http://localhost:9100

步骤 5：启动前端

cd jeecgboot-vue3
npm install
npm run dev

前端默认地址：http://localhost:3000 默认账号：admin / 123456

四、核心用法

4.1 Online 在线建表（零代码）

1. 登录管理后台 → 系统管理 → Online 表单 → 表单配置
2. 选择表模型（单表 / 树表 / 一对多）
3. 可视化配置字段（23 种控件类型）
4. 点"保存"，自动生成前后端 CRUD 代码

-- 不写 Java 代码，通过 Online 配置创建业务表
-- Online 建表会自动生成：Controller、Service、Mapper、Vue 前端代码

4.2 代码生成器（低代码）

1. Online 建表或手工建表
2. 系统管理 → 代码生成 → 生成配置（选择模板：单表/树表/一对多）
3. 点击"生成代码"，下载 ZIP 包
4. 解压到项目对应目录，手工 Merge 到业务代码

生成的代码包含： - Controller（接口） - Service / ServiceImpl（业务逻辑） - Mapper / Entity（数据层） - Vue3 前端页面（列表 + 表单）

4.3 AI 知识库问答（核心 AI 功能）

JeecgBoot 内置类 Dify 的 AI 应用平台：

AI 应用平台功能清单：
- AI 知识库：上传文档（PDF/Word/TXT），自动分块、向量化存储
- AI 对话助手：配置角色 Prompt，对接大模型（DeepSeek 默认）
- AI 应用编排：可视化流程编排（LLM → 知识库检索 → 输出）
- AI 模型管理：统一管理多模型 API Key 和用量
- AI 流程设计器：拖拽设计复杂 AI 业务流程

配置大模型（以 DeepSeek 为例）：

1. 系统管理 → AI 模型管理 → 添加模型
2. 填写 API Key 和模型名称（如 deepseek-chat）
3. 在 AI 应用中引用该模型即可

创建知识库：

1. AI 应用平台 → 知识库 → 新建知识库
2. 上传文档（PDF/Word 等）
3. 配置 Embedding 模型（默认 Ollama 本地模型或 OpenAI）
4. 知识库自动分块入库

4.4 微服务切换（可选）

默认单体架构，如需切换微服务：

# 切换到微服务模式
mvn clean package -Pspringcloud

依赖 Nacos（注册中心）+ Gateway（网关）+ Sentinel（熔断），详见官方文档。

五、典型适用场景

六、坑与注意

⚠️ 版本选择至关重要

• master 分支 = SpringBoot 2（v3.8.3），官方已宣布不再维护。
• 新项目必须用 springboot3 分支，基于 SpringBoot 3.3 + JDK 17，性能和支持周期更好。
• 两个分支代码结构差异较大，升级需要迁移。

⚠️ v3.8.3 基于 SpringBoot 2

• SpringBoot 2 基于 Java 8/11，虽然兼容 Java 17，但部分依赖较老。
• springboot3 分支使用 SpringAuthorizationServer 替代了 Shiro 做权限控制，架构更现代。

⚠️ 代码生成后 Merge 冲突

• 代码生成器覆盖的是模板代码，业务自定义逻辑不会丢失（因为在另外的文件中）。
• 但如果反复生成，需要手工记录 Merge 操作。建议在正式使用前完成全部字段配置，减少返工。

⚠️ AI 功能依赖向量库配置

• 知识库功能需要配置向量库（Milvus/Qdrant）或使用 Ollama 本地 Embedding。
• 默认配置可能有初始学习成本，建议先阅读 AI 应用手册。

⚠️ 大型项目慎用单体

• 代码生成器在项目初期威力巨大，但随业务复杂度增加，单体架构可能成为瓶颈。
• 提前评估是否需要微服务分支，避免后期重构成本。

⚠️ 社区支持主要中文

• 官方文档、QQ 群、博客均为中文，英文资源有限。
• 如果团队以英文为主，这是潜在障碍。

七、与同类对比

结论：如果你的团队有 Java 背景且需要同时构建业务系统 + AI 能力（如企业知识库），JeecgBoot 是独特的选择；单纯 AI 应用编排建议直接用 Dify。

八、一句话结论

JeecgBoot 是 Java 团队的低代码 + AI 应用双料神器，用 Online 配置和代码生成器解决 80% 重复 CRUD，内置类 Dify 的 AI 平台让企业知识库和 AI 助手一步到位，是国内企业数字化转型的实用型选择。

来源

• GitHub README: https://github.com/jeecgboot/JeecgBoot
• 官方文档: https://help.jeecg.com
• AI 应用手册: https://help.jeecg.com/aigc
• 在线演示: https://boot3.jeecg.com（SpringBoot 3 版本）
• 视频教程: http://jeecg.com/doc/video