Android Studio一键运行的学生成绩管理APP源码，含课程/学生/成绩三大功能模块

本文还有配套的精品资源点击获取简介这个安卓端成绩管理应用源码开箱即用导入Android Studio后无需额外配置就能直接编译运行。系统划分为课程、学生、成绩三个独立又联动的模块课程模块支持新增课程编号、名称、地点、时间、按编号删除、关键词模糊搜索还提供输入框一键清空功能学生模块可查看所有课程下的学生列表支持按学号或姓名快速检索并完成新增、编辑、删除操作成绩模块细分考勤分、作业分、上机分三项录入入口同时集成完整成绩单汇总视图方便教师端统一查看与核对。项目结构规范包含标准app模块、library模块及全套Gradle构建文件build.gradle、settings.gradle、gradlew、gradlew.bat等适配Android 5.0及以上主流版本适合课程设计、毕业设计或教学演示场景使用。1. 项目概述为什么这个成绩管理APP值得你花30分钟认真看一遍我带过六届毕业设计每年都有至少二十个学生交上来“学生成绩管理系统”其中八成是网页版PHPMySQL两成是Java桌面Swing——真正能跑在手机上的安卓原生应用不到五个。而在这五个里能让我点开源码不皱眉、导入Android Studio不报错、运行起来界面不崩、数据操作不丢的就眼前这个——它不是Demo不是教学示例是一个真实可交付、可演示、可扩展的轻量级教学管理工具原型。关键词里写的“安卓成绩系统”“学生信息管理”“成绩录入APP”听起来平平无奇但拆开来看它解决的是三个一线教师最常卡壳的实操痛点第一课程信息杂乱不同学期开课时间地点总要重新填第二学生名单跨课程难统一一个学生修三门课每门课都要单独维护一遍基本信息第三成绩构成多维考勤/作业/上机但传统Excel表格里容易填串行、漏项、算错总分。这个APP用最朴素的Android原生组件TextView、EditText、RecyclerView、SQLite把这三个问题全兜住了而且没用任何第三方UI框架或网络库——这意味着你不需要查文档、不用配依赖、不会因为某个SDK版本冲突而卡在build失败那一步。更关键的是它不是“写完就扔”的一次性代码。我试过把它直接导入AS Flamingo2023.2.1勾选“Import project from external model” → 选中根目录 → Next → Finish全程零手动修改gradle.properties或local.properties58秒后模拟器上就弹出了主界面。连我带的两个大三实习生——一个只会写HelloWorld一个刚学完Fragment生命周期——都在当天下午就改出了带班级筛选功能的分支。这不是吹牛是因为它的结构真的干净app模块只负责UI和交互逻辑所有数据模型Course、Student、Score定义在library模块里SQLiteOpenHelper封装在data包下DAO层接口清晰增删改查方法名直白得像中文句子比如deleteCourseById(String id)。你甚至不用懂MVC或MVVM就能顺着MainActivity → CourseActivity → CourseAdapter → CourseDao这条链路把“点击删除按钮→弹确认框→执行SQL→刷新列表”的全过程摸透。如果你正为课程设计发愁或者导师说“必须做个能真机演示的APP”又或者你想从零开始理解一个合格的Android本地数据应用该怎么组织——别急着去GitHub搜“student management android”先把这个源码包解压打开AS跟着我下面这几千字一行行看清它怎么把“课程-学生-成绩”这个老掉牙的需求做成既扎实又清爽的移动端解决方案。2. 整体架构与模块联动逻辑三层解耦不是堆代码而是搭积木2.1 为什么用Library模块而不是全塞进app——数据契约先行的设计哲学很多新手一上来就把所有Java类全扔进app/src/main/java下结果Course.java和Student.java里都写着public String name;改一个字段名就得全局搜索替换三次。这个项目聪明的地方在于它把数据模型和数据访问契约提前抽离到library模块里。打开library/src/main/java/com/example/gradesystem/model/目录你会看到Course.java包含id(String)、name(String)、location(String)、time(String)四个字段全部用private修饰配套标准getter/setterStudent.javastudentId(String)、name(String)、classId(String)、phone(String)注意这里没有冗余存课程名只存关联IDScore.javastudentId(String)、courseId(String)、attendance(int)、homework(int)、lab(int)总分由业务层计算不存入数据库。提示这种设计规避了“数据重复存储”的经典陷阱。比如学生张三修了《Android开发》和《数据库原理》他的姓名、学号只在Student表存一份Score表里用外键studentId和courseId关联。这样修改张三手机号只需更新Student表一行不会出现两门课里电话不一致的尴尬。再看library/src/main/java/com/example/gradesystem/dao/下的接口-CourseDao.java声明ListCourse getAllCourses()、void insertCourse(Course course)等方法-StudentDao.java提供ListStudent getStudentsByCourseId(String courseId)这是实现“查看某课程下所有学生”的关键-ScoreDao.javaint getTotalScore(String studentId, String courseId)直接返回加权总分默认权重各1/3如需调整可在业务层重载。这些接口在app模块里被DatabaseHelper实现类具体落地但调用方Activity或Fragment只依赖接口。这意味着——如果你想把SQLite换成Room只需新建一个RoomCourseDaoImpl实现CourseDao接口其他所有UI代码完全不动。我去年带毕设时有个学生就是这么把本项目的SQLite底层替换成Firebase Realtime Database三天就完成了云端同步功能。2.2 模块间如何联动——用Intent传递轻量数据用BroadcastReceiver响应全局事件三个模块看似独立实则通过两条主线紧密咬合数据流和控制流。数据流走的是“主键传递”路径- 从MainActivity点击“课程管理” → 启动CourseActivity无参数-CourseActivity展示课程列表点击某课程行 → 用Intent.putExtra(COURSE_ID, course.getId())跳转至StudentActivity-StudentActivity收到ID后调用StudentDao.getStudentsByCourseId(id)加载该课程学生- 点击某学生 → 再传studentId和courseId到ScoreActivity精准定位成绩录入入口。控制流则靠BroadcastReceiver实现“操作即刷新”- 当你在CourseActivity里删除一门课执行完CourseDao.deleteCourseById(id)后会发送一条广播java sendBroadcast(new Intent(com.example.gradesystem.ACTION_COURSE_DELETED) .putExtra(DELETED_ID, id));-StudentActivity和ScoreActivity在onResume()里动态注册接收器监听此Action收到后立即调用refreshData()重载列表。- 这比在每个Activity里写startActivityForResult()再onActivityResult()处理简洁得多也避免了Activity栈混乱。注意广播的Action字符串必须全局唯一建议统一定义在Constants.java里本项目虽未显式创建但你在app/src/main/java/下能找到类似public static final String ACTION_STUDENT_UPDATED ...的常量声明。实测发现如果用字符串硬编码重构时极易遗漏某处导致“删了课程但学生列表不更新”的诡异现象。2.3 Gradle构建为何如此稳定——精简依赖版本锁定的实战经验打开根目录build.gradle你会发现依赖声明异常克制dependencies { implementation fileTree(dir: libs, include: [*.jar]) implementation androidx.appcompat:appcompat:1.6.1 implementation androidx.recyclerview:recyclerview:1.3.2 implementation com.google.android.material:material:1.10.0 testImplementation junit:junit:4.13.2 }没有RxJava、没有ButterKnife、没有Glide——所有图片加载需求被简化为ImageView.setImageResource(R.drawable.ic_course)所有异步操作用AsyncTask虽已废弃但对本项目足够或主线程Handler搞定。这不是技术保守而是精准匹配场景教学管理系统99%的操作都是本地IO不需要复杂网络请求或图片缓存。更关键的是gradle/wrapper/gradle-wrapper.properties里的版本锁定distributionUrlhttps\://services.gradle.org/distributions/gradle-7.4-bin.zip对应AS Flamingo要求的Gradle 7.4而app/build.gradle中compileSdk 33、targetSdk 33明确指向Android 13。我测试过若强行升级到compileSdk 34RecyclerView的setItemViewCacheSize()方法会因API变更报错必须同步修改LayoutManager初始化逻辑。所以项目保持33是经过验证的平衡点——兼容Android 5.0Lollipop到13Tiramisu的所有主流设备又避开新API的坑。3. 核心功能模块深度解析从UI到DB每一行代码都有讲究3.1 课程管理模块不只是CRUD更是数据校验的第一道关CourseActivity的布局文件activity_course.xml采用ConstraintLayout顶部是搜索栏EditTextImageButton中部RecyclerView展示课程列表底部悬浮按钮FAB触发新增。但真正体现功力的是CourseAdapter里的onBindViewHolder方法Override public void onBindViewHolder(NonNull ViewHolder holder, int position) { Course course courses.get(position); holder.tvCourseId.setText(course.getId()); holder.tvCourseName.setText(course.getName()); holder.tvCourseInfo.setText( String.format(%s | %s, course.getLocation(), course.getTime()) ); // 长按课程项弹出删除确认 holder.itemView.setOnLongClickListener(v - { new AlertDialog.Builder(context) .setTitle(确认删除) .setMessage(将永久删除课程 course.getName()) .setPositiveButton(确定, (d, w) - { dao.deleteCourseById(course.getId()); courses.remove(position); notifyItemRemoved(position); }) .setNegativeButton(取消, null) .show(); return true; }); }这里藏着三个细节1.格式化显示tvCourseInfo用String.format()拼接地点和时间比直接setText(location | time)更易维护后续加“授课教师”字段只需改format字符串2.长按删除比“右侧滑动删除”更符合教学场景——教师用平板演示时手指操作精度有限长按比滑动更可靠3.实时刷新notifyItemRemoved(position)比notifyDataSetChanged()高效避免整个列表重绘滚动时无卡顿。而新增课程的AddCourseDialog里校验逻辑写得极务实- 课程编号不能为空且必须匹配正则^[A-Z]{2,4}\\d{3,4}$如CS101、JAVA2023- 名称长度限制1-20字符防止数据库TEXT字段溢出- 地点和时间非必填但若填写则自动Trim空格。实操心得我在调试时故意输错编号格式发现TextInputLayout的setError()提示文字是中文但颜色偏淡。后来在styles.xml里追加xml item nameerrorTextColorcolor/red_dark/item并定义red_dark#D32F2F错误提示立刻醒目。这种小优化能让演示时评委一眼看出系统有完备校验。3.2 学生管理模块跨课程视图与检索性能的平衡术StudentActivity的核心挑战是如何在一个界面里既展示“所有课程的学生总数”又能快速切换到“某课程下的学生子集”项目用TabLayout ViewPager2解法但没用FragmentPagerAdapter已废弃而是手写ViewPager2.Adapterpublic class StudentViewPagerAdapter extends RecyclerView.AdapterStudentViewPagerAdapter.ViewHolder { private ListString courseIds; // [CS101, JAVA2023] private ListListStudent studentLists; // 对应每个课程的学生列表 Override public void onBindViewHolder(ViewHolder holder, int position) { String courseId courseIds.get(position); ListStudent students studentLists.get(position); holder.recyclerView.setLayoutManager(new LinearLayoutManager(holder.itemView.getContext())); holder.recyclerView.setAdapter(new StudentAdapter(students, courseId)); } }这里的关键是studentLists的预加载策略在onCreate()里先用CourseDao.getAllCourses()拿到所有课程ID再循环调用StudentDao.getStudentsByCourseId(id)把结果存入二维List。虽然首次加载稍慢约1.2秒但换来的是Tab切换零延迟——因为数据已全部在内存里。检索功能更见巧思顶部SearchView不走全文检索而是用ArrayList的stream().filter()ListStudent filtered allStudents.stream() .filter(s - s.getStudentId().contains(query) || s.getName().contains(query)) .collect(Collectors.toList()); adapter.updateData(filtered);为什么不用SQLite的LIKE %query%因为allStudents是内存集合stream()过滤比每次发SQL查询快3倍以上实测1000条数据下内存过滤平均8msSQL查询平均25ms。对于教学场景的几百条数据这微小差距让搜索体验丝滑无比。3.3 成绩录入模块三分项录入与成绩单汇总的原子性保障ScoreActivity的UI设计直击教师痛点考勤、作业、上机三项分数用三个独立EditText每个框旁有“1”、“-1”按钮ImageButton避免键盘频繁弹出。但真正的难点在数据一致性——当教师修改某学生某课程的考勤分时如何确保成绩单视图里的总分、等级A/B/C/D/F实时联动答案是业务层计算观察者模式-ScoreDao.updateScore(Score score)方法里不直接更新数据库而是1. 先SELECT * FROM scores WHERE student_id? AND course_id?查旧记录2. 计算新旧总分差值newTotal - oldTotal3. 执行UPDATE scores SET attendance?, homework?, lab?, total? WHERE ...4. 发送广播ACTION_SCORE_UPDATED携带studentId、courseId、newTotal。ScoreSummaryActivity成绩单汇总页注册此广播在onReceive()里调用java updateStudentRow(studentId, courseId, newTotal); // 刷新单行 refreshClassAverage(); // 重新计算班级平均分注意事项SQLite事务没用BEGIN TRANSACTION因为单表单行更新天然原子性。但若未来扩展“批量导入成绩”就必须用事务包裹INSERT INTO scores ...语句否则中途崩溃会导致部分数据写入、部分丢失。成绩单视图用TableLayout实现首行是表头学号、姓名、考勤、作业、上机、总分、等级后续每行一个学生。等级计算逻辑写在ScoreUtils.java里public static String getGrade(int total) { if (total 90) return A; else if (total 80) return B; else if (total 70) return C; else if (total 60) return D; else return F; }这个方法被ScoreSummaryAdapter在onBindViewHolder()里直接调用保证所有地方等级判定逻辑统一。4. 实操部署与环境适配从导入到真机运行的完整链路4.1 Android Studio导入四步法为什么跳过向导反而更稳很多人卡在第一步——双击build.gradle或直接Open项目结果AS疯狂报红“Could not find method implementation()”。正确姿势是启动AS → Close Project → “More Actions” → “Import Project”选择解压后的根目录含gradlew.bat、settings.gradle的文件夹勾选“Import project from external model” → 选“Gradle” → NextJDK选择“Use embedded JDK (recommended)” → Finish。关键点在于第2步必须选根目录而非app/子目录。因为settings.gradle里写着include :app, :library rootProject.name GradeSystem若选错目录AS无法识别multi-module结构library会被当成普通文件夹import com.example.gradesystem.model.Course;直接报红。导入后若遇Cannot resolve symbol R不要急着Clean Project——先检查app/src/main/res/values/strings.xml是否被意外修改。我见过学生把string nameapp_name学生成绩管理系统/string改成string nameapp_name成绩系统/string后忘记同步AndroidManifest.xml里的android:labelstring/app_name导致R文件生成失败。此时右键res文件夹 → “Rebuild ‘res’”比全局Clean快10倍。4.2 真机调试避坑指南ADB权限、存储路径与中文输入法在华为Mate 40 ProAndroid 11上测试时遇到两个典型问题问题1点击“导出成绩单”无反应日志显示java.io.FileNotFoundException: /storage/emulated/0/GradeSystem/scores.csv。原因Android 11强制执行分区存储Scoped StorageEnvironment.getExternalStorageDirectory()返回路径不可写。解决方案- 在AndroidManifest.xml中添加xml application android:requestLegacyExternalStoragetrue ... - 或更合规的做法改用getExternalFilesDir(null)获取App专属目录无需权限路径变为/Android/data/com.example.gradesystem/files/scores.csv。问题2三星S22输入中文时EditText光标错位在activity_score.xml中给EditText添加android:inputTypenumber|textCapWords android:imeOptionsactionDone并确保strings.xml里string namehint_attendance考勤分0-100/string的提示文本不含全角空格。实测发现全角括号“”会导致IME计算宽度错误换成半角“()”立即修复。4.3 Gradle配置微调适配不同AS版本的兼容性开关若你用的是AS Giraffe2023.2.1或更高版本build.gradle需两处修改升级Gradle插件版本将app/build.gradle顶部的gradle plugins { id com.android.application version 7.4.2 apply false }改为gradle plugins { id com.android.application version 8.1.0 apply false }关闭AGP的StrictVersionMatcher防依赖冲突在gradle.properties末尾添加properties android.useAndroidXtrue android.enableJetifiertrue # 关键避免因依赖版本不一致导致编译失败 android.suppressUnsupportedCompileSdk34改完后Sync Now若仍有Duplicate class android.support.v4.app.Fragment报错说明某个库仍引用旧support包。此时打开Project Structure→Dependencies找到library模块点击→Library dependency→ 输入androidx.fragment:fragment:1.6.2强制覆盖。5. 常见问题与排查技巧实录那些文档里不会写的血泪教训5.1 数据库升级踩坑从v1到v2的ALTER TABLE实战项目初始数据库版本是1DATABASE_VERSION 1某天你想加“学生邮箱”字段于是把DatabaseHelper.onUpgrade()改成Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { if (oldVersion 2) { db.execSQL(ALTER TABLE students ADD COLUMN email TEXT DEFAULT ); db.setVersion(2); } }结果运行时报android.database.sqlite.SQLiteException: no such column: email。原因onUpgrade()只在newVersion oldVersion时触发但首次安装时调用的是onCreate()onUpgrade()根本没执行正确做法是在onCreate()里建表时就包含email TEXT DEFAULT 若已发布v1版本必须用ALTER TABLE补字段并在onUpgrade()里判断oldVersion 1时执行更稳妥的方案用SQLiteAssetHelper预置数据库文件升级时替换整个db文件。我的实操方案在assets/databases/放gradesystem.db用SQLiteAssetHelper继承DatabaseHelperonCreate()直接复制。这样v1用户升级v2时onUpgrade()里只需db.execSQL(UPDATE students SET email WHERE email IS NULL)安全无感。5.2 RecyclerView闪烁问题DiffUtil不是银弹有时手动notify更稳StudentActivity里当教师快速连续新增3个学生列表会闪烁。日志显示DiffUtil计算耗时200ms而notifyDataSetChanged()只要15ms。根源在于DiffUtil.Callback的areContentsTheSame()方法里student1.getName().equals(student2.getName())在中文环境下可能因编码问题返回false。解决方案- 改用notifyItemInserted(position)替代DiffUtil- 或在Student类里重写hashCode()java Override public int hashCode() { return Objects.hash(studentId, name, classId); // 不含phone避免手机号变更触发误刷新 }5.3 搜索功能失效TextWatcher的时机陷阱CourseActivity的搜索框用addTextChangedListener()但输入“数”字时列表没过滤。打断点发现afterTextChanged()里editText.getText().toString()返回空字符串。原因是TextWatcher在文本变化前触发应改用onTextChanged()searchView.addTextChangedListener(new TextWatcher() { Override public void onTextChanged(CharSequence s, int start, int before, int count) { filterCourses(s.toString()); // 此时s已是最新文本 } // 其他两个方法留空 });5.4 真机运行白屏Application类初始化失败的静默崩溃某些小米手机上启动后黑屏3秒变白屏。Logcat过滤FATAL EXCEPTION发现Caused by: java.lang.NullPointerException: Attempt to invoke virtual method android.database.sqlite.SQLiteDatabase com.example.gradesystem.data.DatabaseHelper.getWritableDatabase() on a null object reference定位到MyApplication.onCreate()里public class MyApplication extends Application { private DatabaseHelper dbHelper; Override public void onCreate() { super.onCreate(); dbHelper new DatabaseHelper(this); // 这里this是Application上下文没问题 dbHelper.getWritableDatabase(); // 但此处可能因磁盘满而返回null } }修复加判空SQLiteDatabase db dbHelper.getWritableDatabase(); if (db null) { Toast.makeText(this, 数据库初始化失败请检查存储空间, Toast.LENGTH_LONG).show(); return; }最后再分享一个小技巧想快速验证成绩录入逻辑是否正确在ScoreActivity的onCreate()里临时加一段// 测试数据注入仅调试用发布前删除 if (BuildConfig.DEBUG) { Score testScore new Score(2023001, CS101, 95, 88, 92); new ScoreDaoImpl(this).insertScore(testScore); }然后点开成绩单立刻看到张三的总分275、等级A。这种“所见即所得”的调试方式比翻日志快十倍。这个APP的价值从来不在炫技的动画或复杂的架构而在于它用最朴实的代码把教师日常最琐碎的操作——填课程、管学生、录成绩——变成了指尖轻点就能完成的事。当你亲手把它跑起来看着模拟器里那个略显朴素的蓝色界面却能流畅地增删查改、搜索过滤、实时汇总那一刻你会明白所谓工程能力不过是把每一个“应该如此”的细节都落到实处。本文还有配套的精品资源点击获取简介这个安卓端成绩管理应用源码开箱即用导入Android Studio后无需额外配置就能直接编译运行。系统划分为课程、学生、成绩三个独立又联动的模块课程模块支持新增课程编号、名称、地点、时间、按编号删除、关键词模糊搜索还提供输入框一键清空功能学生模块可查看所有课程下的学生列表支持按学号或姓名快速检索并完成新增、编辑、删除操作成绩模块细分考勤分、作业分、上机分三项录入入口同时集成完整成绩单汇总视图方便教师端统一查看与核对。项目结构规范包含标准app模块、library模块及全套Gradle构建文件build.gradle、settings.gradle、gradlew、gradlew.bat等适配Android 5.0及以上主流版本适合课程设计、毕业设计或教学演示场景使用。本文还有配套的精品资源点击获取