简介这是一份基于命令行的学生成绩管理系统 Java 实现面向 Java 初学者、课程设计者以及需要轻量成绩管理方案的小型教育机构重点解决学生信息维护、成绩录入与统计等常见问题。压缩包共44个文件包含18个Java源码、18个class可运行文件、5个XML配置以及项目配置文件等整体仅98KB结构精简便于直接运行和阅读。系统覆盖学生信息管理、成绩录入、查询、修改、统计以及数据存储等核心模块代码运用 Java IO 流、集合框架和面向对象设计模块划分清晰。当前已有197人学习下载适合用于课设作业、入门项目复盘或在此基础上扩展在线访问、GUI界面等进阶功能。整体资源小巧而完整能够帮助学习者以较低成本快速上手 CLI 应用开发并理解真实项目的组织方式。1. 项目概述与整体设计思路1.1 为什么是命令行 Java这个组合拿到基于命令行的学生成绩管理系统这个需求时我的第一反应是这确实是最适合Java初学者练手的项目之一。原因不复杂——真正的Web系统涉及Spring Boot、MyBatis、数据库那一套东西对于刚学完Java基础语法、集合框架、IO流的人来说门槛还是偏高的。而命令行版本恰好能把Java SE阶段最核心的知识点全部串起来类与对象、封装继承、集合框架、异常处理、文件读写、输入输出流一个都不少。命令行Command Line本质上就是我们和程序交互的最原始方式程序启动后打印菜单用户输入数字或命令程序执行对应操作并输出结果。Windows下的cmd、PowerShellLinux和macOS下的终端都是命令行环境。选它做载体有一个隐形的好处能强制你养成程序入口 → 业务分发 → 具体实现的分层思维这东西以后写任何项目都用得上。这套系统能干什么说白了就是替代Excel表用键盘管理学生成绩录入新学生、录入各科成绩、修改信息、删除记录、按条件查询、统计平均分/及格率、从文件加载数据、把数据保存到文件。适合谁来参考刚学完Java基础想做个完整项目的人、准备面试前想快速复习IO和集合用法的人、以及教学场景下需要一个可演示的课堂案例的人。1.2 功能需求与模块划分我按照增删改查 统计分析 持久化三条线来拆功能。第一是基础管理线学生信息的录入、修改、删除、按学号或姓名查找这对应数据库里的CRUD操作。第二是统计线单科成绩的平均分、最高分、最低分、及格率、按总分排名这是这个系统的价值核心。第三是持久化线把内存中的数据保存到文件下次启动时再加载回来对应真实项目中数据不丢的底线要求。模块划分上我分成四层入口层Main类负责启动和菜单循环、控制层MenuHandler解析用户输入并调度业务、业务层StudentService实现核心逻辑、数据层StudentRepository持有集合、封装对数据的操作。这么做的好处是以后想换UI比如改成JavaFX图形界面只需要改入口层和部分控制层业务层和数据层完全不用动。2. 核心数据结构与存储方案选型2.1 内存数据结构ArrayList还是HashMap学生数据在内存里用什么结构存是第一个要想清楚的问题。我见过很多新手直接写一个ArrayListStudent就上路了但实际做下来你会发现两个问题第一修改和删除时定位元素要用Index而Index在集合变化后会漂移容易误操作第二查找某个学生要线性遍历学生多了效率感人。我的方案是数据主干用ArrayList 同时建立一个MapString, Integer作为学号索引。学号是String类型的Map的Key存学号Value存该学生在ArrayList里的下标。这样按下标操作数组保证修改和删除是O(1)定位按学号查询走Map的哈希查找也不用遍历。新增学生时先检查Map里有没有相同学号有就拒绝保证唯一性约束这其实就是数据库主键的内存版实现。Student类的字段设计没有花哨的name、studentId、grade三件套就够了——年级信息留着方便以后按年级分组统计。如果做的是高中场景可以再加className班级名按班级汇总成绩也是常见需求。我会用double类型存成绩避免int对小数分天然不友好。2.2 数据持久化文本文件还是序列化说实话序列化ObjectOutputStream写起来确实爽——对象直接变成字节流落盘读回来也方便。但我最后还是选择了纯文本格式CSV风格原因有两个第一文本文件能直接打开查看和修改。学生成绩这种数据老师双击就能看到也可以用Excel打开拿去打印或者二次加工都方便。序列化文件是二进制必须用程序才能读对用户来说就是个黑盒。第二序列化有个版本兼容问题如果Student类加了字段没配serialVersionUID老文件反序列化直接报InvalidClassException。文本格式就没有这个毛病就算加了字段解析时兼容处理也容易。我定的存储格式是每行一条记录字段用逗号分隔学号,姓名,年级,Java,MySQL,English。写入时用BufferedWriter按行写读取时用BufferedReader按行读再split(,)转成Student对象。这里有一个细节必须注意写文件时要指定编码读文件时也要指定编码而且两边要一致否则乱码问题会让你怀疑人生。我统一用UTF-8通过new OutputStreamWriter(new FileOutputStream(file), StandardCharsets.UTF_8)来包装不用FileWriter的默认编码。2.3 数据层设计的关键解耦数据层这个类我命名为StudentRepository它负责两件事持有内存集合提供对集合的增删改查接口。它不关心用户输入了什么不关心菜单怎么显示只管拿到参数就执行操作。StudentService调到它的时候传入一个Student对象或者学号字符串拿回一个boolean或者List 作为结果。为什么要这样抽一层因为以后你想把数据源从文件换成MySQL只需要改Repository的实现类Service层的代码一行都不用动。这种面向接口编程的感觉你写一次命令行项目就能体会到比看十遍设计模式的书都管用。3. 实操过程与核心环节实现3.1 环境准备与工程结构我用的环境是JDK 11 VSCode没有引任何第三方依赖纯JDK API完成。建议你也用JDK 8以上版本再低的话语法支持和工具链支持都不太友好。环境变量配置这里提醒一句装完JDK后命令行执行java -version验证一下如果出现java不是内部或外部命令多半是JAVA_HOME没配好或者Path变量里的路径指向了旧版本JDK比如C盘装了Java 8又装了Java 17Path里的顺序决定系统用哪个。项目结构建议用Maven标准目录即使你没用Maven也把目录结构组织成这个风格后面迁移到Maven/Gradle省事student-manager/ ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/example/student/ │ │ │ ├── Main.java │ │ │ ├── model/Student.java │ │ │ ├── repository/StudentRepository.java │ │ │ ├── service/StudentService.java │ │ │ └── ui/MenuHandler.java │ │ └── resources/ │ └── test/ ├── data/ │ └── students.txt └── pom.xml可选data目录专门放数据文件这样代码里的路径写死为data/students.txt相对路径在大多数环境下都能正确解析。如果直接输入students.txt文件会被创建在当前工作目录下有时候你根本不知道它跑到哪去了。3.2 入口与菜单循环不能写得像死程序Main类的任务非常专注创建Repository、Service、MenuHandler然后调用MenuHandler的start()进入循环。这里有一个我必须强调的写法主菜单循环要允许返回上一级而不是退出程序。比如你从主菜单进入成绩管理子菜单操作完一条记录应该回到成绩管理再操作一条最后按0返回主菜单按q才退出程序。如果每次操作完都退回主菜单用户体验很割裂。所以我把菜单循环设计成了嵌套结构public void start() { while (true) { printMainMenu(); String choice scanner.nextLine(); if (q.equalsIgnoreCase(choice)) { System.out.println(数据已保存感谢使用学生成绩管理系统); break; } switch (choice) { case 1 - studentMenu(); case 2 - queryMenu(); case 3 - service.listAll(); case 4 - service.saveToFile(); default - System.out.println(无效选项请重新输入。); } } }这个循环的条件是while(true)靠break跳出。看起来简单粗暴但在命令行程序里这是最清晰的模式。它等价于一个前台服务——永久等待用户输入直到用户明确要求退出。退出前自动调用保存逻辑防止用户改了数据忘记存盘。细节决定体验每次打印菜单前调用clearScreen()在Windows里执行cmd /c clsLinux里是clear清屏后菜单列表不至于无限滚屏每个子操作结束后打印提示并Press Enter to continue...用scanner.nextLine()吞掉回车给用户一个阅读反馈的时间。3.3 成绩统计和排名最有含金量的代码统计模块是业务核心我专门写了一个Statistics类输入List 输出统计结果这样测试起来也方便。平均分、最高分、最低分都好理解及格率的计算要注意**及格线按科目可能不同**——Java和English按60分及格但如果你以后加入实操考核满分50分及格线就变成30分。所以我在Statistics里设计了一个可配置的passMark参数默认60没有写死。排名我用的是Comparator List.sort。按总分降序排列总分相同时按学号升序这样排名稳定可预测public ListStudent rankByTotal(ListStudent students) { ListStudent copy new ArrayList(students); copy.sort((s1, s2) - { int compare Double.compare(s2.getTotalScore(), s1.getTotalScore()); if (compare 0) { return s1.getStudentId().compareTo(s2.getStudentId()); } return compare; }); return copy; }注意这里的getTotalScore()在Student类里是一个计算方法返回JavaMySQLEnglish三门成绩之和。我们不单独存总分这个字段因为存了反而麻烦——改任何一门成绩总分都得跟着变容易出错。用计算字段代替存储字段是这里最重要的设计决策。还有一个容易踩的坑排序后排名要输出名次遍历时用System.out.printf(%2d. %s - 总分%.1f%n, i 1, student.getName(), student.getTotalScore())格式化对齐。纯靠字符串拼接你会看到一排歪歪扭扭的输出在命令行界面上非常掉价。3.4 文件保存与加载中文编码和路径问题保存逻辑我上面提到了用UTF-8包装。加载逻辑是它的逆操作还有一个文件不存在的例外处理第一次启动时data目录和students.txt都不存在加载模块要捕获FileNotFoundException然后静默初始化一个空列表而不是直接让程序崩溃。等到用户执行保存操作时再通过Files.createDirectories()自动把目录建好。解析每一行时还要防御脏数据按逗号split后数组长度必须等于6try-catch包裹Double.parseDouble转成绩任何一条解析失败都要打日志打印到控制台并跳过该行不能因为一个坏行让整个系统起不来。这个脏数据行跳过的逻辑我建议保留因为用户很可能手动编辑过这个文本文件。3.5 Maven命令行构建与运行虽然这个项目不引第三方依赖但我仍然推荐用Maven来管理构建顺便把编译和打包标准化。不用IDE里的绿色按钮直接练命令行操作mvn clean compile mvn exec:java -Dexec.mainClasscom.example.student.Main如果你配了exec-maven-plugin的话上面两条就能跑起来。如果没配用标准三件套mvn clean package后在target/目录下会生成一个jar包。这时候直接java -jar target/student-manager-1.0-SNAPSHOT.jar运行如果报无主清单属性no main manifest attribute说明pom.xml里少配了maven-jar-plugin的mainClass。这是命令行构建最常遇到的错误之一解决方案是显式加一行manifest mainClasscom.example.student.Main/mainClass /manifest我每次跑项目都用mvn clean install -DskipTests一方面确认依赖是完整的另一方面习惯性地把本地仓库和target目录保持干净排查问题的时候少很多干扰因素。4. 常见问题与排查技巧实录4.1 中文乱码windows命令行永远的痛这几乎是每个Windows上跑Java命令行项目的人都会遇到的。表现是程序里输出的中文全部变成乱码或者从文件读出来的中文变成锟斤拷。原因链条是这样的Java的默认Charset在Java 18之前是跟随系统默认区域的Windows中文系统通常是GBK而我的代码强制用UTF-8写文件、读文件控制台输出又经过cmd的默认编码GBK去解码三条线彻底拧巴了。解决办法分三个层面代码层面所有文件读写都显式指定UTF-8用InputStreamReader/OutputStreamWriter包装运行层面在启动命令加参数java -Dfile.encodingUTF-8 -jar student-manager.jar如果还乱那就是cmd窗口本身的问题在cmd窗口标题栏右键 → 属性 → 字体改成Lucida Console或新宋体然后执行一次chcp 65001切换代码页到UTF-8再重启Java程序基本就解决了。我的经验是能靠代码解决的就别靠环境设置因为你永远不知道用户会在什么终端里跑你的jar包。所有文件操作显式给Charset出口统一用PrintStream并且包装时指定编码这样至少程序自己控制范围内不会乱。4.2 Scanner被吞输入nextInt后接nextLine的坑这是一个教科书级的隐藏Bug。用户在菜单里输入数字选项比如1我用scanner.nextLine()去读没问题。但如果你图省事写了scanner.nextInt()读数字接下来再用scanner.nextLine()读姓名就会出现姓名还没来得及输入程序就跳过了的现象。原因是nextInt()只拿走了数字回车符还留在缓冲区里紧接着的nextLine()读到的是这个残留的回车直接返回空字符串。解决办法有两种第一永远只用nextLine()读取用户的原始输入然后手动做类型转换Integer.parseInt、Double.parseDouble像这样String raw scanner.nextLine(); int choice Integer.parseInt(raw.trim());第二如果实在要用nextInt()后面手动补一个scanner.nextLine()把残留换行吃掉。但要我说第一种才是根治而且当你naive读入非法字符时第一种方式优雅得多——捕获NumberFormatException提示输入必须是数字程序继续跑而不是直接抛InputMismatchException崩溃用户一脸懵。4.3 数字格式化与浮点数运算误差学生成绩如果出现9.999999999这种诡异输出别慌浮点数的经典问题。Java的double和float在计算机内部是二进制表示的像61.3这类小数无法精确表示计算多位小数后误差会累积。解决办法展示时统一用printf的%格式化输出保留1位或2位小数而不是直接println拼接原始double值。如果你要拿这些成绩做精确计算比如奖学金排名建议用BigDecimal传入金额或成绩时用String构造器而不是new BigDecimal(double)后者仍然带有二进制误差。这个项目因为只是展示成绩和平均分精度要求是1位小数所以用printf格式化就足够了。成本最低效果也是肉眼可见的干净。4.4 数据文件被Excel编辑后编码变化导致解析失败有一个我踩过的大坑我给老师的系统她用Excel打开students.txt编辑了一个学生的成绩后保存。结果Excel默认以ANSI编码保存部分中文变成乱码我程序一加载就爆解析异常。解决方案是双管齐下程序里解析行时增加健壮性判断——split后数组长度不对的直接跳过并记录行号编码上我放弃手动建UTF-8文件然后试图让用户别乱改这种不现实的想法改为读文件时先做BOM检测BOM为EF BB BF识别为UTF-8否则尝试GBK解码。有了这个兜底逻辑不管是UTF-8还是ANSI系统都能正确读出来。命令行程序很多时候要同时兼容不同用户的使用习惯防御性编程不是空话。4.5 退出时机和保存策略的选择还有个交互设计的点想分享我建议不要每次增删改查后都自动保存到文件而是退出时统一保存 手动提供保存命令。为什么因为文本文件的IO操作虽小但频繁每次操作都写盘会让程序响应变慢更关键的是如果用户做了一连串误操作他还有回退的余地——退出前再保存给他一个反悔的空间。但这个策略有个风险用户改了数据后直接关终端不通过菜单退出数据没保存就丢了。我在启动加载文件时记录了文件最后修改时间每次进入菜单循环前比较一下当前时间如果发现文件被外部修改比如Excel改过会提醒数据文件已被外部修改是否重新加载。这算是我自己加的一个小彩蛋功能但实用性很强。写在最后的经验之谈我做这个项目的最大感受是命令行程序虽然古老但它是一个把代码能跑提升到设计合理的最佳训练场。这个项目的合理规模是1200到2000行代码没有框架帮你兜底没有IDE帮你生成代码每一行都需要自己思考。我做完之后对Java集合框架和IO的理解比刷一百道练习题都透彻。最后再分享一个小技巧给Student类重写toString()方法让它返回[学号] 姓名 (Java: 85.0 / MySQL: 92.0 / English: 78.0)这种紧凑格式。别小看这个方法命令行程序的输出整洁程度很大程度取决于你有没有认真设计toString。代码里的每一个让用户看得舒服的细节累积起来就是软件质感的全部来源。本文还有配套的精品资源点击获取