一套仓库，三种模式；一行 SQL ，全栈生成； AI 加持，开箱即用。
本版本是一次承前启后的重大升级，围绕「前端工程全面 TypeScript 化」「React 全新前端版本交付」「AI + SKILL 驱动开发」三大核心亮点展开，让中后台业务开发从此进入 AI 辅助时代。
一、Release Notes （ v2.1.0 · 2026-08-30 ）
- 1 、 [新增] React 前端版本发布：React + Vite + AntDesign + TypeScript 前端工程正式交付，与 Vue 模式共享统一后端 API ，随生产构建并行发布；
- 2 、 [新增] Vue 前端版本升级 TypeScript：Vue3 与 React 前端模块全面升级 TypeScript ，类型约束更严谨、IDE 提示更完善；
- 3 、 [新增] AI + SKILL 驱动开发：仓库内置
xxl-boot-monolith / xxl-boot-vue / xxl-boot-react三大开发 SKILL ，AI 编程助手可自动识别并加载，按平台规范直生业务代码、自动落位并附校验清单，加速业务开发； - 4 、 [新增] 前端规范增强：Vue 模块引入 ESLint + Prettier ，React 模块引入 Biome ，提升代码规范性与可维护性；
- 5 、 [新增] 代码生成器兼容 TypeScript：生成器支持前端
type/types文件，并内置 vue3/react 前端模板（ types/api/view ），前后端分离（ Vue/React ）模式可一键生成前端代码； - 6 、 [新增] “新增业务模块”支持三方式：传统手工、内置代码生成器、AI + SKILL 驱动，均输出等价代码与菜单权限 SQL ，可混合切换；
- 7 、 [文档] 官方文档重构：快速入门按 单体 / Vue / React 三种模式分述；操作指南改为“能力总览 + 分章节详解”总分结构；新增“新增业务模块”三方式详解；总体设计完善（新增 三种运行模式、统一响应规范、业务扩展与菜单零路由、AI + Skill 辅助开发设计）等章节；
- 8 、 [升级] 升级多项依赖至较新版本。
二、三大亮点速览
亮点一：前端工程全面 TypeScript 化
Vue3 与 React 双前端模块均完成 TypeScript 升级，配合 Vite 构建工具，类型约束更严谨、IDE 智能提示更完善，从编译期即可发现大量隐患，让团队协作与长期维护更加可靠。
亮点二：React 全新前端版本正式交付
v2.1.0 正式发布 React 前端版本（ xxl-boot-ui-react ），采用 React + Vite + AntDesign + TypeScript 技术栈，与 Vue 模式共享同一套后端 API ，三种模式如同一套「前后端骨架」，按团队技术栈自由选型。
亮点三：AI + SKILL 驱动开发
仓库内置 xxl-boot-monolith / xxl-boot-vue / xxl-boot-react 三大开发 SKILL 。接入 AI 编程助手（如 opencode ）后，只需描述业务诉求，AI 便会自动加载对应 SKILL ，按平台规范直生业务代码、自动落位并附校验清单，业务开发正式进入 AI 辅助时代。
三、Docker Compose 快速部署
v2.1.0 延续并强化了 Docker Compose 一键部署能力，内置 三种运行模式 的编排配置，均可一条命令拉起整套环境：
| 运行模式 | Docker 编排目录 | 前端技术栈 | 端口 |
|---|---|---|---|
| A 、单体模式 | docker/monolith |
AdminLTE + FreeMarker | 8080 |
| B 、前后端分离 Vue | docker/modular-vue |
Vue3 + ElementPlus | 8090 + 3000 |
| C 、前后端分离 React | docker/modular-react |
React + AntDesign | 8090 + 4000 |
以 前后端分离 Vue 模式 为例，一键部署步骤如下：
// 第一步：前往仓库目录，并构建项目
cd ./xxl-boot
mvn clean package -Dmaven.test.skip=true
// 第二步：进入 docker/modular-vue 目录，自定义 .env 配置
// 如修改 MYSQL_PATH / REDIS_PATH 设置数据持久化目录、MYSQL_ROOT_PASSWORD 数据库密码等
cd ./docker/modular-vue/
cat .env
// 第三步：启动项目（停止使用 docker compose down ）
docker compose up -d
说明：
- 编排会自动拉起 MySQL （ xxl_boot 库）、Redis、xxl-boot-api 与 xxl-boot-ui-vue 四个容器；
- 数据库初始化脚本（
tables_xxl_boot.sql+tables_xxl_boot_modular_vue.sql）已挂载至 MySQL 首次启动目录，数据库首启会自动建表初始化，开箱即用；- 访问地址：前端
http://localhost:3000，默认账号admin / 123456；- 单体模式 / React 模式仅编排目录与前端镜像不同，操作流程完全一致。
四、新增业务模块：三方式任选
v2.1.0 将「新增一个带列表、增删改查的业务模块」沉淀为三种标准化方式，产出可无缝切换：
| 方式 | 适用场景 | 特点 | 产出物 |
|---|---|---|---|
| A 、传统手工方式 | 字段特殊、深度定制 | 可控性最强 | 手工全套后端 + 前端代码 |
| B 、内置代码生成器 | 标准化 CRUD 模块 | 一行 SQL 全栈生成、含菜单 SQL | 后端 6 件套 + 前端 3 文件 + init SQL |
| C 、AI + SKILL 方式 | 已接入 AI 助手、追求极致效率 | 全自动编排直生 + 自动落位 + 校验清单 | 与生成器等价的全套代码 + SQL |
代码生成：只需在后台「工具-代码生成」录入一条建表 SQL ，即可自动生成后端 controller/service/mapper&xml/entity 与前端 types/api/view 全套代码，并附带「菜单 + 按钮 + 授权」初始化 SQL — 从数据库到可运行页面一键打通。
AI + SKILL：打开 AI 编程助手（如 opencode ）打开仓库，通过 /xxl-boot-vue 等前缀调用对应 SKILL 并描述诉求，AI 会依次完成「需求澄清 → 数据建模 → 后端 → 前端 → 菜单权限 → 联调验证」，全自动落位交付。
五、关于 XXL-BOOT
XXL-BOOT 是一个易学易用、AI 驱动、开箱即用的快速开发平台，内置安全登录、RBAC 权限管控、端到端代码生成、AI + SKILL 加速开发、响应式 UI 等能力，整合流行前后端技术，致力为中小企业与个人开发者打造开箱即用的中后台解决方案。
一套仓库，三种模式
采用 Monorepo 统一托管三种工程形态 —— 单体（xxl-boot-admin）、前后端分离 Vue （xxl-boot-api + xxl-boot-ui-vue）、前后端分离 React （xxl-boot-api + xxl-boot-ui-react）。按业务诉求三选一，统一版本管理、一键构建、按需部署，切换成本极低。
核心特性
- 快速开发：Monorepo 三种模式、AI + SKILL 驱动、代码生成、表单构建；
- 账号与安全：XXL-SSO 安全登录、RBAC 权限管控、审计日志、异常防护；
- 系统管理：用户 / 角色 / 资源 / 组织 / 字典 / 配置中心 / 站内消息 / 在线用户 / 系统监控；
- 研发与架构：响应式 UI 、国际化（中英双语言）、标准分层研发规范、丰富分布式扩展能力。
六、功能界面一览
略
Select Language