使用 SmartAdmin 进行前后端开发，通常分为"本地环境搭建与部署"和"日常业务开发（代码生成）"两个主要阶段。以下是具体的操作流程：
一、 环境准备与本地部署
在开始开发前，需要确保本地环境满足要求（推荐 JDK 8/17、Node.js 20.x、MySQL 8.0），然后按照以下顺序进行前后端联动启动：
1. 数据库初始化（核心第一步）
- 创建数据库（如
smart_admin_v3）并配置专属用户与密码。 - 进入项目源码的
数据库SQL脚本/mysql目录，执行smart_admin_v3.sql脚本，系统会自动创建100多张表并初始化默认管理员账号（admin / 1024ok）。
2. 后端服务启动
- 进入对应的后端目录（如
smart-admin-api-java8-springboot2）。 - 修改配置文件
application.yml中的数据库连接信息（URL、用户名、密码）。 - 执行 Maven 打包命令
mvn clean package -Dmaven.test.skip=true，然后通过java -jar命令启动后端服务。启动成功后，默认端口通常为 8080。
3. 前端应用启动
- 进入前端目录（提供 JavaScript 和 TypeScript 双版本，如
smart-admin-web-typescript）。 - 执行
npm install安装项目依赖。 - 配置环境变量，将 API 接口地址指向后端服务（如
VITE_APP_API_BASE_URL=http://localhost:8080）。 - 执行
npm run dev启动前端开发服务，随后即可通过浏览器访问系统登录界面。
二、 日常业务开发（代码生成器实战）
SmartAdmin 最核心的优势是其内置的代码生成器，能够大幅提升 CRUD（增删改查）业务的开发效率。具体使用流程如下：
1. 数据库表设计与元数据解析
- 在数据库中创建好业务表，务必规范填写字段注释 。例如，使用
COMMENT '状态(0-禁用,1-启用)'的格式，系统能够智能识别并自动将其转化为前端下拉选择组件。 - 登录 SmartAdmin 后台，进入"代码生成器"模块，搜索并选择目标表，系统会自动通过 JDBC 解析表结构并展示字段列表。
2. 生成配置与预览
- 在配置表单中填写基础信息，如去除表前缀（如
t_）、设置业务模块名称、Java 包名以及前端存放路径等。 - 配置字段映射关系，选择前端组件类型。
- 点击"预览"按钮，检查生成的前后端代码是否符合预期，确认无误后执行生成。
3. 代码集成与验证
- 将生成的后端代码（Controller、Service、DAO、Model 等）和前端代码（API、Views 等）分别复制到项目的对应模块目录中。
- 在后端执行
mvn clean install重新构建，并在前端的路由文件中注册新页面的路由。 - 重启应用，访问新生成的页面，测试增删改查功能是否正常运行。