XXL-BOOT v2.1.0 发布：React 全新上线 · 全栈 TypeScript · AI+SKILL 驱动开发

一套仓库，三种模式；一行 SQL，全栈生成；AI 加持，开箱即用。

XXL-BOOT 快速开发平台 v2.1.0 版本正式发布！

本版本是一次承前启后的重大升级，围绕「前端工程全面 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 模式 为例，一键部署步骤如下：

bash 复制代码

// 第一步：前往仓库目录，并构建项目
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）。按业务诉求三选一，统一版本管理、一键构建、按需部署，切换成本极低。