# exam

**Repository Path**: CodingInDark/exam

## Basic Information

- **Project Name**: exam
- **Description**: web答题or刷题系统（单选题版），为了刷题自由做的小应用。
- **Primary Language**: Python
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-15
- **Last Updated**: 2026-01-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Python

## README

# exam刷题小站 - 在线刷题练习平台

#### 介绍
这是一个专为 Windows 电脑​ 设计的轻量级在线考试系统，无需安装 Python 环境，双击 app.exe即可直接运行。系统支持从 Excel 导入题库、配置考试参数（如题库目录），并提供答题页与成绩页的核心功能。
为了自考做了这个小应用，准确说是为了单选题多的几门公共课，目前来说够用

功能亮点
📝 目前已实现选择题；

📊 可视化答题卡：直观展示题目状态（未作答/已作答/标记），快速定位薄弱环节；

⏳ 模拟考试倒计时：精准计时，培养时间管理能力，适配“限时考试”场景；

📈 答题进度跟踪：实时显示「已完成题数/总题数」，学习效果一目了然；

🔧 轻量化部署：前后端分离架构，本地开发/生产部署成本极低，新手友好；

#### 项目结构


```
exam/
├─ templates/       # Flask 前端模板目录（Flask 默认渲染此文件夹下的 HTML）
│  ├─ index.html    # 考试答题页（动态加载题目、计时、提交答案）
│  └─ score.html    # 成绩展示页（显示分数、错题分析等）
├─ app.exe          # 打包后的可执行文件（Windows 双击直接运行，无需装 Python）
├─ app.py           # Python 后端主程序（Flask 框架实现路由、数据处理）
├─ config.txt       # 配置文件（存储考试参数，如题库目录、刷题数等）
└─ questions.xlsx   # Excel 题库（存储题目、选项、正确答案等）
```

#### 快速开始
##### 1. 直接运行（普通用户）
若仅需使用考试系统，无需修改代码，直接双击 exam文件夹下的 app.exe即可启动：
双击 app.exe→ 自动打开浏览器进入答题页 → 完成答题后提交 → 查看成绩页。
##### 2. 开发模式（开发者/修改需求）
若需修改配置或后端逻辑，需先搭建 Python 环境并安装依赖

#### 题库与配置说明
1. 题库文件：questions.xlsx
需按以下固定格式编辑 Excel（每列含义需严格对应）：

| question | option1 | option2 | option3 | option4 | correct_answer | answer_analysis |
|----------|---------|---------|---------|---------|----------------|-----------------|
| 问题       | 选项1     | 选项2     | 选项3     | 选项4     | 正确答案           | 解析              |
| Python的创始人是？       | 盖茨     | 龟叔     | 扎克伯格     | 马云     | 龟叔           | Python由吉多·范罗苏姆（Guido van Rossum）创建，昵称“龟叔”              |

2. 配置文件：config.txt
文本文件，每行一个键值对（格式：键=值），示例：

```
EXCEL_PATH=          # 答题系统配置文件完整路径
RUN_PORT=5000        # 运行端口
QUESTION_COUNT=20    # 答题数量控制

```