【若依框架】从零构建学生管理系统：代码生成实战指南

1. 环境准备与项目初始化在开始构建学生管理系统之前我们需要先准备好开发环境。我推荐使用IntelliJ IDEA作为开发工具它提供了强大的Java开发支持。同时确保你已经安装了以下环境JDK 1.8或更高版本Maven 3.6MySQL 5.7首先从若依官网下载最新版本的框架代码。我建议选择RuoYi-Vue版本它采用了前后端分离的架构更适合现代Web开发。解压后导入到IDEA中等待Maven依赖下载完成。提示若依框架默认使用3306端口连接MySQL如果你的MySQL服务端口不同记得修改ruoyi-admin模块下的application-druid.yml配置文件。第一次启动项目前需要先执行数据库脚本。找到项目中的sql文件夹按顺序执行ry_2021xxxx.sql主数据库脚本quartz.sql定时任务相关表启动顺序很重要我建议先启动后端服务RuoYiApplication主启动类再启动前端npm run dev2. 数据库设计与表创建学生管理系统的核心是学生信息表我们需要设计合理的表结构。根据我的项目经验一个完整的学生表应该包含以下字段CREATE TABLE stu_student ( student_id int(11) NOT NULL AUTO_INCREMENT COMMENT 学号, student_name varchar(50) NOT NULL COMMENT 学生姓名, gender char(1) DEFAULT 0 COMMENT 性别0男 1女, age int(3) DEFAULT NULL COMMENT 年龄, class_id int(11) DEFAULT NULL COMMENT 班级ID, phone varchar(20) DEFAULT NULL COMMENT 联系电话, email varchar(50) DEFAULT NULL COMMENT 邮箱, address varchar(255) DEFAULT NULL COMMENT 家庭住址, status char(1) DEFAULT 0 COMMENT 状态0在读 1休学 2毕业, create_time datetime DEFAULT NULL COMMENT 创建时间, update_time datetime DEFAULT NULL COMMENT 更新时间, PRIMARY KEY (student_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT学生信息表;在实际项目中我建议再创建班级表、课程表等关联表。但为了演示代码生成功能我们先用这个单表结构。注意若依的代码生成器要求表和字段都必须有注释这些注释会直接显示在前端页面上。3. 模块创建与依赖配置为了保持项目结构清晰我们应该为学生管理创建独立的模块。在父项目的pom.xml旁边右键 - New - Module选择Maven模块名称为ruoyi-student在父pom.xml中添加子模块声明modules moduleruoyi-admin/module moduleruoyi-student/module /modules在ruoyi-admin的pom.xml中添加依赖dependency groupIdcom.ruoyi/groupId artifactIdruoyi-student/artifactId version${ruoyi.version}/version /dependency在ruoyi-student的pom.xml中添加基础依赖dependencies !-- 核心依赖 -- dependency groupIdcom.ruoyi/groupId artifactIdruoyi-common/artifactId /dependency !-- 其他必要依赖 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency /dependencies4. 代码生成器配置与使用现在来到最核心的代码生成环节。首先修改代码生成配置我习惯使用多模块方式所以修改ruoyi-generator中的generator.ymlgen: author: yourname packageName: com.ruoyi.student autoRemovePre: true tablePrefix: stu_然后按照以下步骤生成代码登录系统后台进入系统工具 - 代码生成点击导入按钮选择刚才创建的stu_student表点击编辑按钮配置生成选项生成模块名student生成业务名info生成包路径com.ruoyi.student上级菜单选择系统管理或新建学生管理菜单点击生成代码按钮下载生成的zip包解压后会看到完整的代码结构包含后端代码Controller/Service/Mapper/Entity前端Vue组件SQL菜单脚本5. 代码整合与菜单配置将生成的代码整合到项目中后端代码将main/java下的代码复制到ruoyi-student的src/main/java将resources/mapper下的XML文件复制到对应位置前端代码将vue/api下的JS文件复制到ruoyi-ui/src/api将vue/views下的Vue组件复制到ruoyi-ui/src/views执行SQL脚本在MySQL中执行生成的SQL文件创建菜单和权限这里有个我踩过的坑如果前端路由路径配置不正确会导致页面空白。检查生成的vue文件中的路径是否与菜单配置一致。6. 功能测试与常见问题解决重启前后端服务你应该能看到学生管理菜单。测试增删改查功能时可能会遇到以下问题页面显示异常检查浏览器控制台是否有404错误确保前端api路径与后端Controller的RequestMapping一致提交表单报错检查实体类字段类型与表结构是否匹配查看后端日志中的SQL异常权限问题在系统管理 - 角色管理中分配菜单权限清除浏览器缓存重新登录我建议在生成的代码基础上可以进一步优化添加数据校验注解完善异常处理自定义查询条件7. 项目扩展与高级功能完成基础功能后可以考虑扩展以下功能班级管理模块创建班级表建立与学生表的一对多关系使用若依的树形表格展示班级结构成绩管理创建成绩表实现学生-课程-成绩的关联查询使用ECharts集成成绩统计图表自定义模板修改ruoyi-generator中的vm模板添加自定义的代码生成逻辑实现更复杂的业务场景我在实际项目中发现合理使用若依的代码生成器可以节省70%以上的CRUD开发时间让你更专注于业务逻辑的实现。