18 KiB
18 KiB
学生成绩管理系统
一个功能完整的C语言学生成绩管理系统，支持学生信息管理、成绩统计分析、用户权限控制等功能。采用高度模块化设计，代码结构清晰，易于维护和扩展。
📋 目录
✨ 功能特性
🎯 核心功能
- 学生信息管理：添加、删除、修改、查询学生信息
- 成绩管理：支持多门课程成绩录入和管理
- 数据持久化：CSV格式存储，便于查看和编辑
- 统计分析：课程分析、成绩分布、排名统计等
- 用户管理：多用户登录、权限控制
🔧 技术特性
- 标准化目录结构：v4.1.0版本采用业界标准的include/src目录布局
- 统一类型管理：v4.0.0版本创建types.h统一管理所有数据结构
- 全局变量优化：排序参数和统计缓存移至全局作用域，提升性能
- 高度模块化：v2.2版本完成深度模块化重构，功能模块职责清晰
- 工具库分离：独立的IO、验证、字符串、文件、数学、系统工具模块
- 输入验证：完善的数据校验机制
- 错误处理：友好的错误提示和异常处理
- 彩色输出：美观的控制台界面
- 编译优化：支持直接编译，无需生成中间.o文件
- 跨平台：支持Windows、Linux、macOS
🏗️ 系统架构
学生成绩管理系统 (v4.1.0 标准化目录架构)
├── 用户界面层 (UI Layer)
│ ├── 主菜单 (src/main_menu.c)
│ └── 学生IO操作 (src/student_io.c)
├── 业务逻辑层 (Business Layer)
│ ├── 核心处理器 (src/core_handlers.c)
│ ├── 学生CRUD操作 (src/student_crud.c)
│ ├── 学生搜索 (src/student_search.c)
│ ├── 学生排序 (src/student_sort.c)
│ ├── 统计分析 (src/statistical_analysis.c)
│ └── 用户管理 (src/user_manage.c)
├── 工具库层 (Utility Layer)
│ ├── IO工具 (src/io_utils.c)
│ ├── 验证工具 (src/validation.c)
│ ├── 字符串工具 (src/string_utils.c)
│ ├── 文件工具 (src/file_utils.c)
│ ├── 数学工具 (src/math_utils.c)
│ ├── 系统工具 (src/system_utils.c)
│ └── 安全工具 (src/security_utils.c)
├── 数据访问层 (Data Layer)
│ ├── CSV文件操作
│ └── 数据验证
├── 安装包管理层 (Installer Layer)
│ ├── 安装脚本目录 (installer/)
│ ├── Inno Setup脚本 (installer/installer.iss)
│ ├── NSIS脚本 (installer/installer.nsi)
│ └── 安装包输出 (installer/dist/)
└── 配置层 (Config Layer)
├── 头文件目录 (include/) - v4.1.0标准化
├── 统一类型定义 (include/types.h)
├── 系统配置 (include/config.h)
└── 全局变量 (include/globals.h)
🚀 安装与编译
环境要求
- GCC编译器 4.8+
- C99标准支持
- 操作系统：Windows/Linux/macOS
编译步骤
- 克隆项目
git clone <repository-url>
cd Stu_scores_system
- 使用GCC编译
gcc -Wall -Wextra -std=c17 -g -Iinclude -o student_system src/main.c src/core_handlers.c src/file_utils.c src/globals.c src/io_utils.c src/main_menu.c src/math_utils.c src/security_utils.c src/statistical_analysis.c src/string_utils.c src/student_crud.c src/student_io.c src/student_search.c src/student_sort.c src/system_utils.c src/user_manage.c src/validation.c
- 使用Makefile编译（v4.0.0优化版）
make
注意: v4.0.0版本在v2.2直接编译模式基础上，进一步优化了类型管理和依赖关系，编译更加高效，并增强了系统安全性。
- 运行程序
./student_system.exe # Windows
./student_system # Linux/macOS
📖 使用说明
登录系统
系统提供两个默认用户：
- 管理员：用户名
admin，密码123456（拥有所有权限） - 教师：用户名
teacher，密码password（基本权限）
主要功能
1. 基本功能管理
- 添加学生：录入学生基本信息和课程成绩
- 删除学生：根据学号删除学生记录
- 修改学生：更新学生信息和成绩
- 查询学生：按学号或姓名查找学生
- 显示所有学生：列出所有学生信息
- 排序功能：按学号、姓名、总分、平均分排序
2. 统计分析功能
- 课程分析：各科目成绩统计
- 成绩分布：分数段分布统计
- 成绩区间：优秀、良好、及格、不及格统计
- 综合分析：整体成绩概况
3. 管理功能（仅管理员）
- 用户管理：添加、删除用户
- 密码修改：修改用户密码
- 权限控制：管理用户权限级别
📊 数据格式
CSV文件结构
学生数据以CSV格式存储在 data/students.csv：
学号,姓名,年龄,性别,课程数量,课程1,成绩1,课程2,成绩2,...,总分,平均分
2021001,张三,20,M,3,数学,85.50,英语,92.00,物理,78.50,258.00,86.00
用户数据
用户信息存储在 data/users.txt：
用户名:密码:权限级别
admin:123456:1
teacher:password:0
详细格式说明请参考：CSV格式文档
📁 项目结构
Stu_scores_system/ (v4.1.0 标准化目录结构)
├── 📁 data/ # 数据文件目录
│ ├── students.csv # 学生数据（CSV格式）
│ └── users.txt # 用户数据
├── 📁 include/ # 头文件目录
│ ├── config.h # 系统配置
│ ├── core_handlers.h # 核心处理器
│ ├── file_utils.h # 文件操作工具库
│ ├── globals.h # 全局变量管理
│ ├── io_utils.h # IO工具库
│ ├── main_menu.h # 菜单系统
│ ├── math_utils.h # 数学计算工具库
│ ├── security_utils.h # 安全工具库
│ ├── statistical_analysis.h # 统计分析功能
│ ├── string_utils.h # 字符串工具库
│ ├── student_crud.h # 学生CRUD操作
│ ├── student_io.h # 学生IO操作
│ ├── student_search.h # 学生搜索功能
│ ├── student_sort.h # 学生排序功能
│ ├── system_utils.h # 系统工具库
│ ├── types.h # 统一数据类型定义
│ ├── user_manage.h # 用户管理
│ └── validation.h # 数据验证工具库
├── 📁 installer/ # 安装包管理目录
│ ├── installer.iss # Inno Setup安装脚本
│ ├── installer.nsi # NSIS安装脚本
│ └── 📁 dist/ # 安装包输出目录
│ ├── StudentGradeSystem_Inno_Setup.exe # Inno Setup安装包
│ └── StudentGradeSystem_NSIS_Setup.exe # NSIS安装包
├── 📁 src/ # 源文件目录
│ ├── core_handlers.c # 核心处理器
│ ├── file_utils.c # 文件操作工具库
│ ├── globals.c # 全局变量管理
│ ├── io_utils.c # IO工具库
│ ├── main.c # 主程序入口
│ ├── main_menu.c # 菜单系统
│ ├── math_utils.c # 数学计算工具库
│ ├── security_utils.c # 安全工具库
│ ├── statistical_analysis.c # 统计分析功能
│ ├── string_utils.c # 字符串工具库
│ ├── student_crud.c # 学生CRUD操作
│ ├── student_io.c # 学生IO操作
│ ├── student_search.c # 学生搜索功能
│ ├── student_sort.c # 学生排序功能
│ ├── system_utils.c # 系统工具库
│ ├── user_manage.c # 用户管理
│ └── validation.c # 数据验证工具库
├── 📁 MD/ # 文档目录
│ └── CSV_FORMAT.md # CSV格式说明
├── 📁 TXT/ # 文本文档目录
│ ├── 系统说明文档.txt # 系统详细说明
│ ├── 代码统计报告.txt # 代码统计分析
│ └── 要求.txt # 需求文档
├── 📄 .gitignore # Git忽略文件配置
├── 📄 LICENSE # 许可证文件
├── 📄 Makefile # 编译配置（v4.1.0优化版）
├── 📄 README.md # 项目说明文档
└── 📄 student_system.exe # 编译生成的可执行文件
🛠️ 开发指南
代码规范
- 使用C99标准
- 函数命名采用驼峰命名法
- 变量命名使用有意义的英文单词
- 每个函数都有详细的注释说明
- 模块化设计，职责分离
添加新功能
- 在
src/目录的相应模块文件中添加函数实现 - 在
include/目录的对应头文件中添加函数声明 - 在菜单系统中添加选项
- 更新配置文件（如需要）
- 使用
make clean && make重新编译 - 编写测试用例
目录结构说明
- src/：存放所有
.c源文件，包含函数的具体实现 - include/：存放所有
.h头文件，包含函数声明和数据结构定义 - data/：存放程序运行时的数据文件（CSV、TXT等）
- MD/：存放Markdown格式的文档文件
- TXT/：存放文本格式的说明文档
核心数据结构
学生信息结构体
typedef struct {
char studentID[MAX_ID_LENGTH]; // 学号
char name[MAX_NAME_LENGTH]; // 姓名
int age; // 年龄
char gender; // 性别 ('M'/'F')
char courses[MAX_COURSES][MAX_COURSE_NAME_LENGTH]; // 课程名称
float scores[MAX_COURSES]; // 各科成绩
int courseCount; // 课程数量
float totalScore; // 总分
float averageScore; // 平均分
} Student;
用户信息结构体
typedef struct {
char username[MAX_USERNAME_LENGTH]; // 用户名
char password[MAX_PASSWORD_LENGTH]; // 密码
bool isAdmin; // 是否为管理员
} User;
统计分析结构体
// 课程统计信息
typedef struct {
int studentCount; // 学生人数
float maxScore; // 最高分
float minScore; // 最低分
float totalScore; // 总分
float averageScore; // 平均分
float passRate; // 及格率
} CourseStats;
// 分数分布统计
typedef struct {
int excellent; // 优秀(90-100分)
int good; // 良好(80-89分)
int medium; // 中等(70-79分)
int pass; // 及格(60-69分)
int fail; // 不及格(0-59分)
} ScoreDistribution;
// 总体统计信息
typedef struct {
int totalStudents; // 学生总数
int maleCount; // 男生人数
int femaleCount; // 女生人数
float averageAge; // 平均年龄
float highestAverage; // 最高平均分
float lowestAverage; // 最低平均分
float overallAverageScore; // 总体平均分
float standardDeviation; // 标准差
int totalCourses; // 课程总数
float averageCoursesPerStudent; // 人均课程数
} OverallStats;
🔧 配置说明
系统参数（config.h）
#define MAX_STUDENTS 1000 // 最大学生数量
#define MAX_COURSES 10 // 每个学生最多课程数
#define MAX_USERS 50 // 最大用户数量
#define MAX_LOGIN_ATTEMPTS 3 // 最大登录尝试次数
文件路径
#define STUDENTS_FILE "data/students.csv" // 学生数据文件
#define USERS_FILE "data/users.txt" // 用户数据文件
#define BACKUP_DIR "backup/" // 备份目录
🚨 注意事项
- 数据安全：定期备份数据文件
- 权限管理：谨慎分配管理员权限
- 输入验证：系统会自动验证输入数据的合法性
- 文件编码：CSV文件使用UTF-8编码，支持中文
- 并发访问：当前版本不支持多用户同时操作
🐛 常见问题
Q: 编译时出现错误怎么办？
A: 确保源文件在 src/ 目录下，头文件在 include/ 目录下，并检查GCC版本是否支持C17标准。使用 make clean && make 重新编译。
Q: 数据文件损坏怎么办？
A: 可以从backup目录恢复备份文件，或者手动编辑CSV文件修复数据。
Q: 忘记管理员密码怎么办？
A: 可以直接编辑 data/users.txt 文件重置密码。
Q: 如何导入现有的学生数据？
A: 按照CSV格式要求编辑 data/students.csv 文件，程序会自动读取。
🤝 贡献指南
欢迎提交Issue和Pull Request！
- Fork本项目
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启Pull Request
📄 许可证
本项目采用MIT许可证 - 查看 LICENSE 文件了解详情。
👥 作者
- 开发者 - 学生成绩管理系统
- 联系方式 - [3364451258@qq.com]
🙏 致谢
感谢所有为这个项目做出贡献的开发者！
版本: v4.1.0
最后更新: 2025年
状态: 稳定版本
🆕 v4.1.0 更新内容
📁 标准化目录结构
- 目录重组：将源文件和头文件分别组织到
src/和include/目录 - 编译优化：更新 Makefile 以支持新的目录结构，添加
-Iinclude编译选项 - 项目标准化：采用业界标准的C项目目录布局，提升项目专业性
- 维护性提升：清晰的文件组织结构，便于代码管理和团队协作
🔧 编译系统改进
- GCC命令更新：编译命令适配新的目录结构，包含完整的编译选项
- Makefile增强：支持跨平台编译，Windows兼容性改进
- 文档同步：README.md项目结构图完全更新，反映最新的目录组织
🆕 v4.0.0 更新内容
🔒 安全性增强
- 密码安全：实现SHA-256哈希算法，替代明文密码存储
- 缓冲区保护：修复所有缓冲区溢出风险，替换不安全函数
- 输入验证：加强所有用户输入的验证和边界检查
- 内存安全：添加安全内存清除功能，防止敏感数据残留
🛡️ 新增安全模块
- security_utils.c/h：完整的密码哈希和安全工具库
- 增强验证函数：课程名称、用户名、密码强度、索引边界检查
- 安全输入处理：所有输入点添加格式验证和循环检查
🆕 v3.0.0 更新内容
🏗️ 统一类型管理系统
- types.h创建：集中管理所有数据结构定义，包括Student、User、CourseStats、ScoreDistribution、StudentRank、OverallStats、StatisticsCache
- 重复定义消除：移除config.h、globals.h、statistical_analysis.h中的重复结构体定义
- 依赖关系优化：简化头文件包含关系，避免循环依赖问题
🔧 全局变量优化
- 排序参数全局化：将currentSortCriteria和currentSortOrder移至全局作用域
- 统计缓存全局化：将statsCache移至全局管理，提升性能和数据一致性
- 架构一致性：统一全局变量管理策略，提高代码可维护性
⚡ 编译和维护性提升
- 编译效率优化：减少头文件依赖，加快编译速度
- 代码一致性：统一的数据类型管理，降低维护成本
- 扩展性增强：为后续功能扩展奠定坚实的架构基础
🆕 v2.2.0 更新内容
🔧 模块化重构
- auxiliary.c完全拆分：原有的辅助功能模块已完全模块化，拆分为6个专门的工具库
- 新增工具库模块：
io_utils: 输入输出工具函数validation: 数据验证工具函数string_utils: 字符串处理工具函数file_utils: 文件操作工具函数math_utils: 数学计算工具函数system_utils: 系统相关工具函数
- 功能模块细分：
student_crud: 学生增删改操作student_search: 学生查询功能student_io: 学生数据输入输出
⚡ 编译优化
- Makefile优化：采用直接编译模式，不再生成中间.o文件
- 编译效率提升：简化编译流程，减少文件管理复杂度
- 更清洁的构建：避免.o文件堆积，保持项目目录整洁
📈 代码质量提升
- 模块职责更清晰：每个模块功能单一，便于维护
- 代码复用性增强：工具库函数可在多个模块间共享
- 依赖关系优化：减少模块间的耦合度