学生查询系统基于 ASP.NET Core Blazor Server 10.0 构建的学生信息查询系统使用 Excel 文件作为数据源支持动态列适配和响应式布局。功能特性灵活查询支持按姓名、学号进行模糊查询可单独或组合使用动态列适配不写死列名自动读取 Excel 第一行作为列头行列变化时无需修改代码响应式布局基于 Bootstrap 5PC 端和移动端自适应显示零配置部署无需数据库直接更新 Excel 文件即可刷新数据无后台管理轻量级设计专注查询功能技术栈.NET 10.0/ ASP.NET Core Blazor ServerEPPlus 8.x- Excel 文件读写Bootstrap 5- UI 框架Bootstrap Icons- 图标库项目结构StudentQuery/ ├── Components/ │ ├── Layout/ │ │ └── MainLayout.razor # 主布局无侧边栏 │ ├── Pages/ │ │ ├── StudentQuery.razor # 查询页面首页 │ │ ├── Error.razor # 错误页面 │ │ └── NotFound.razor # 404 页面 │ ├── App.razor # 应用入口HTML 模板 │ ├── Routes.razor # 路由组件 │ └── _Imports.razor # 全局 using 引用 ├── Services/ │ └── StudentQueryService.cs # Excel 数据读取与查询服务 ├── wwwroot/ │ └── app.css # 全局样式含响应式适配 ├── data/ │ └── students.xlsx # 学生数据文件 ├── Program.cs # 应用启动入口 └── StudentQuery.csproj # 项目配置快速开始环境要求.NET 10.0 SDK 或更高版本支持现代浏览器的设备Chrome、Edge、Safari、Firefox 等本地运行# 进入项目目录 cd D:\Source\StudentQuery # 还原依赖 dotnet restore # 运行应用默认 http://localhost:5000 dotnet run --urlshttp://localhost:5000浏览器访问http://localhost:5000即可使用。发布部署# 发布到指定目录 dotnet publish -c Release -o ./publish # 部署后运行 cd ./publish dotnet StudentQuery.dll --urlshttp://0.0.0.0:5000数据文件格式Excel 文件要求文件位置data/students.xlsx第一行列名表头程序会动态读取第二行起数据行必需列至少包含姓名和学号列列名需包含这两个关键词示例格式序号姓名学号班级分数1分数2扩展列1张三2505010701125级药学8班6090702李四2501010505125级护理6班709580更新数据直接编辑data/students.xlsx文件可增加、删除、重命名列无需修改代码程序每次查询时实时读取文件无需重启应用配置说明修改端口# 命令行指定端口 dotnet run --urlshttp://localhost:8080 # 或使用环境变量 export ASPNETCORE_URLShttp://localhost:8080修改数据文件路径编辑Services/StudentQueryService.cs_excelPath Path.Combine(AppDomain.CurrentDomain.BaseDirectory, data, students.xlsx); // 修改为自定义路径查询逻辑姓名列匹配查找包含姓名关键词的列如姓名、学生姓名学号列匹配查找包含学号关键词的列如学号、学生编号匹配方式模糊匹配包含即可不区分大小写组合查询姓名和学号同时满足AND 逻辑空条件处理两个条件都为空时不返回结果注意事项列名关键词确保 Excel 中至少有一列包含姓名、一列包含学号文件占用更新 Excel 时确保没有其他进程锁定文件性能考虑数据量较大时10000行建议考虑数据库方案许可证EPPlus 使用非商业个人许可证商业用途需购买授权常见问题Q: 修改了 Excel 文件但查询结果没变A: 程序每次查询都会重新读取文件请确认文件已保存且格式正确。Q: 可以修改查询条件吗A: 可以编辑Services/StudentQueryService.cs中的QueryStudents方法自定义匹配逻辑。Q: 支持多个 Excel 文件吗A: 当前版本仅支持单个文件可自行扩展为多文件或目录扫描。许可证本项目使用 EPPlus 处理 Excel 文件遵循其非商业许可协议。开源地址https://github.com/lishewen/StudentQuery运行效果图