# v-stu

**Repository Path**: Xinqi412/v-stu

## Basic Information

- **Project Name**: v-stu
- **Description**: 学生信息管理系统
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-26
- **Last Updated**: 2026-05-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 学生信息管理系统 (v-stu)

一个基于 Vue 3 + TypeScript + Element Plus 构建的高效、简洁的学生信息管理系统。

## 🚀 功能特性

- **Excel 深度集成**：支持读取 `.xlsx` 和 `.xls` 文件，自动识别表头并生成动态表格。
- **智能交互表格**：
  - **实时编辑**：点击单元格即可直接修改数据。
  - **动态排序**：支持所有列的智能排序（包括字符串和数字）。
  - **多维度检索**：提供每一列的独立搜索框，支持复杂的组合过滤。
- **数据持久化**：使用浏览器的 `LocalStorage` 存储数据，刷新页面或关闭浏览器后数据不丢失。
- **高效录入**：支持弹窗添加数据，并提供“保存并继续添加”功能，适合大批量录入。
- **导出报表**：一键将当前修改后的数据导出为 Excel 文件。
- **响应式布局**：针对不同屏幕尺寸优化的紧凑型 UI，支持表格内部垂直滚动，固定表头和操作区。

## 🛠️ 技术栈

- **框架**: [Vue 3 (Composition API)](https://vuejs.org/)
- **开发工具**: [Vite](https://vitejs.dev/)
- **编程语言**: [TypeScript](https://www.typescriptlang.org/)
- **UI 组件库**: [Element Plus](https://element-plus.org/)
- **Excel 处理**: [SheetJS (xlsx)](https://sheetjs.com/)
- **图标**: [@element-plus/icons-vue](https://element-plus.org/en-US/component/icon.html)

## 📦 快速开始

### 1. 克隆项目
```bash
git clone https://gitee.com/Xinqi412/v-stu.git
cd v-stu
```

### 2. 安装依赖
```bash
npm install
```

### 3. 运行开发服务器
```bash
npm run dev
```

### 4. 生成样例数据 (可选)
项目根目录下包含一个脚本，可以快速生成包含 20 条详细学生信息的 Excel 样例文件：
```bash
node generate_sample.js
```

## 📝 使用指南

1. **导入数据**：点击页面顶部的“导入 Excel”按钮，选择您的学生信息表（或使用生成的 `student_sample.xlsx`）。
2. **检索与排序**：在表格上方的“多维度检索”区域输入关键词，或点击表头进行排序。
3. **修改数据**：直接点击表格中的文字即可进入编辑状态，修改后失去焦点自动保存。
4. **新增数据**：点击“添加数据”按钮，在弹窗中录入。
5. **保存结果**：点击“导出”按钮，下载修改后的 Excel 文件。

## 📄 许可证

MIT License