引言
JeecgBoot是一款基于Spring Boot、集成AI功能的低代码开发平台，采用前后端分离架构（Vue3 + Ant Design）。其强大的代码生成器可以一键生成前后端代码，帮助Java开发者解决大部分重复工作，让开发更关注业务。本次我们使用最新的v3.8.3版本，该版本全面拥抱Spring Boot 3和Java 21生态，在性能和安全性上都有显著提升。

💻 第一阶段：环境准备与项目下载

这是所有项目开始的基础，确保你的开发环境满足要求。

1. 环境要求

   • JDK：JDK 17 或 JDK 21。v3.8.3已全面转向Spring Boot 3，推荐使用JDK 17或21以获得最佳兼容性和性能。

   • Maven：3.6+。

   • MySQL：5.7 或 8.0 版本。

   • Redis：5.0+。

   • Node.js：16+ 及 npm（用于前端开发）。

2. 源码获取
   推荐从官方代码仓库下载，以获得最新最稳定的代码：

   • Gitee：https://gitee.com/jeecg/JeecgBoot

   • Github：https://github.com/jeecgboot/JeecgBoot

   下载后，解压到你的本地工作目录。

🛠️ 第二阶段：数据库与后端配置

成功下载项目后，我们需要让它在本地跑起来。

1. 创建数据库
   使用你的MySQL客户端（如Navicat、MySQL Workbench或命令行），创建一个新的数据库，例如 jeecg_boot。

2. 配置数据库连接
   找到后端项目中的配置文件 /src/main/resources/application-dev.yml（或者根据你的环境选择 application.yml）。
   修改 数据源 部分，将其中的 url、username 和 password 替换为你自己MySQL服务的连接信息。

3. 启动后端项目
   你可以使用IDE（如IntelliJ IDEA）直接运行 JeecgSystemApplication 类的 main 方法，也可以在项目根目录下使用Maven命令启动：

mvn clean spring-boot:run

        启动成功后，在日志中你会看到类似 Jeecg-Boot startup success 的信息，并且Tomcat服务会默认运行在 8080 端口。

⚙️ 第三阶段：前端配置与启动

后端服务运行后，我们接着启动前端项目来呈现完整的用户界面。

1. 安装依赖
   在命令行中，进入前端项目根目录（通常是 ant-design-vue-jeecg），运行以下命令来安装项目所需的npm包：

npm install

1. 建议将npm镜像源设置为国内镜像（如 https://registry.npmmirror.com）以加速下载。

2. 启动前端服务
   依赖安装完成后，运行启动命令：

npm run serve

1. 命令执行完毕后，根据命令行输出的提示（通常是 http://localhost:3000），在浏览器中访问该地址即可看到JeecgBoot的登录页面。

🚀 第四阶段：登录系统并生成第一个功能

现在，整个项目已经在你的本地机器上完全运行起来了。让我们体验JeecgBoot最核心的低代码能力。

1. 系统登录与初始化

   • 在登录页，使用默认的超级管理员账号：用户名 admin，密码 123456 登录系统。

   • 首次登录时，系统可能会提示你进行数据初始化，点击确认即可。

2. 使用在线表单开发
   这是JeecgBoot低代码功能的核心，通过简单配置就能快速生成基础业务的增删改查页面。

   • 进入功能：登录后，在系统左侧菜单栏中找到并点击 "在线开发" -> "Online表单开发"。

   • 创建新表：点击 "创建表单" 按钮，开始定义你的第一张数据表。

   • 填写表单信息：这是一个关键步骤，你需要填写表单的基本信息和设计表结构。

     • 表单信息：包括"表名"、"表单描述"等。

     • 字段信息：点击"新增"按钮，为你的表添加字段。务必注意，"字段备注"必须填写，因为在生成的页面中，它会作为表单项目的标签名称显示。例如，你可以创建一个"学生表"，并添加"姓名"、"学号"等字段。

3. 同步与代码生成

   • 同步数据库：表单字段设计完成后，点击 "同步数据库" 按钮。系统会自动在你在步骤2.1中创建的数据库里生成对应的物理表。

   • 生成代码：同步成功后，点击 "代码生成" 按钮。系统会一键生成该表对应的前后端代码，并打包提供下载。

4. 配置菜单权限

   • 菜单管理：进入 "系统管理" -> "菜单管理"。

   • 添加新菜单：在系统管理目录下，点击 "菜单录入"。将你在代码生成后得到的"配置地址"（通常是一个路由路径）填写到"菜单地址"字段中，并设置好菜单名称和图标。

   • 授权：进入 "系统管理" -> "角色管理"，为当前登录的用户（如admin）所在的角色，授权这个新创建的菜单权限。

5. 功能验证
   注销当前用户后重新登录，你就能在菜单栏中看到刚刚创建的功能菜单。点击进入，即可对之前创建的数据表进行增、删、改、查等全套操作。

💎 实践小结与避坑指南

通过以上步骤，你已经成功体验了JeecgBoot低代码平台的核心工作流。最后，为你总结几个关键点：

• 版本选择：v3.8.3是JeecgBoot迈向Spring Boot 3时代的标志性版本。请注意，它将是最后一个支持Spring Boot 2的版本，后续将只维护Spring Boot 3分支。建议新项目直接基于此版本开发。

• 核心概念：理解 "在线表单开发" -> "同步数据库" -> "代码生成" -> "菜单配置" 这个流程，就掌握了JeecgBoot最基本也是最强大的使用方法。

• 常见问题：

  • 启动失败：首先检查JDK版本是否为17或21，并确认MySQL、Redis服务是否正常启动且连接信息正确。

  • 前端依赖安装慢或失败：务必切换npm到国内镜像源。

  • 页面无数据：检查后端控制台是否有SQL报错，确认数据库表是否同步成功。