简介面向目标检测与课堂行为分析场景的数据集资源覆盖YOLOv5、YOLOv8、YOLO11等常用框架适用于学生课堂行为识别模型的训练与验证。包内共2000个文件含1999个txt标注文件和1个data.yaml配置文件压缩后约503MB。txt文件为YOLO格式的标签信息data.yaml中已写好类别与数据集路径配合划分好的训练集、验证集和测试集可直接用于模型训练省去自行采集、标注与拆分数据的繁琐流程。6个类别覆盖举手、阅读、书写、使用手机、低头、趴在桌子上等典型课堂行为能支撑教学质量分析、学生专注度评估等应用。目前已有346人学习资料整体结构清晰适合目标检测入门及课堂场景项目开发者直接使用。无论是快速验证YOLO训练流程还是搭建课堂行为监测原型都能显著降低前期数据准备时间。1. 2000 张标注好的课堂行为检测数据集它的“开箱即用”是有前提的一份标注好的学生课堂行为检测数据集yolov5/yolov8/yolo11 通用2000 多张图、6 个类别训练集、验证集、测试集已经划分好data.yaml 也配好了——光看这些关键词很多人的第一反应是“下载下来直接yolo train跑一晚上就能出模型”。我见过太多人卡在这一步训练跑完 mAP 是 0或者压根没训练起来最后回头查才发现是 data.yaml 的路径在换机器后失效或者标签文件里混着空 txt。这份数据集的“开箱即用”是有前提的前提是它的目录结构、标签格式和配置能被当前 YOLO 版本正确读到。这篇文章就把从拿到数据集到训出可用模型的全过程拆开讲适合做毕设、课程设计或者想快速验证课堂场景算法方案的读者。新手能按步骤跑通老手可以重点看第 5 章的排错清单。2. 开箱先做数据体检data.yaml、标签文件和图片对不上训练必翻车2.1 拆目录结构训练集、验证集、测试集怎么划分images 与 labels 如何配对拿到数据集第一件事不是打开 data.yaml 看目录而是先看整体目录长什么样。YOLO 系列的数据组织约定非常固定常见做法是images/下按train/、val/、test/分三个子目录labels/下同样按train/、val/、test/分三个子目录images/train/0001.jpg对应的标注是labels/train/0001.txt文件名完全一致只有后缀不同每个 txt 里一行一个目标格式是class_id x_center y_center width height前一项是类别 id后四项是归一化后的框坐标取值范围 [0, 1]。这个配对逻辑是所有 YOLO 训练的前提。你在终端里跑yolo trainUltralytics 会按 data.yaml 里给 train 路径找到图片目录再去同级的 labels 目录找同名 txt。所以一旦有人把 labels 目录嵌套错了比如labels/train/labels/0001.txt训练时每个 batch 都会丢标签表现就是 loss 一路下降但 mAP 永远为零。拿到这份数据集后我建议先在项目根目录执行find . -maxdepth 3 -type d看一眼目录层级。性别 check 对象data.yaml 里 train/val/test 指向的路径和实际目录是否一一对应val 和 test 是否存在且非空。val 尤其重要因为训练过程里的早停、选 best.pt 全靠它val 路径写错或指向空目录训练直接报警告或提前结束。2.2 读 data.yaml6 个类别从哪里看出来names 和 class id 怎么对应data.yaml 是整个训练流程的“黑匣子钥匙”它告诉 YOLO 三件事数据放哪、有几个类别、类别叫什么名字。一份标准的 YOLOv8 data.yaml 长这样path: ./dataset train: images/train val: images/val test: images/test nc: 6 names: 0: hand_raise 1: reading 2: writing 3: sleeping 4: play_phone 5: standingnc必须和names的长度一致这是最常见的低级错误点。names里的顺序就是标注 txt 里 class_id 的索引标签里第一行第一个数字是 2那这个框就对应names里下标为 2 的类别。这意味着哪怕两个数据集类别数量相同、含义相同只要 names 顺序不同模型学到的映射就是错的。我习惯拿到数据集后先不训练直接执行python -c import yaml; print(yaml.safe_load(open(data.yaml))[names])把类别打印出来扫一眼。课堂行为检测的 6 个类别通常是举手、阅读、书写、睡觉、玩手机、站立这类动作具体以你手上这份 data.yaml 的 names 为准。如果发现 names 里混入了看不懂的英文缩写去翻一下数据集附带类别说明别猜。猜错一个类别 id整次训练的意义就没了。2.3 写一个 50 行的体检脚本查配对、查越界、查空标签、查坏图“开箱即用”不等于免检。我的习惯是先跑一遍数据体检耗时几分钟但能避免挂机跑一晚上后才发现方向错了。下面这个脚本可以一次性检查四类问题标签缺失、类别号越界、坐标越界、图片损坏。import cv2 import yaml from pathlib import Path cfg yaml.safe_load(open(data.yaml, encodingutf-8)) names cfg[names] num_classes len(names) for split in [train, val, test]: if split not in cfg: continue img_dir Path(cfg[split]) lbl_dir img_dir.parent / labels / img_dir.name if not lbl_dir.exists(): print(f[{split}] 标签目录不存在: {lbl_dir}) continue for img_path in sorted(img_dir.glob(*.jpg)): txt_path lbl_dir / (img_path.stem .txt) if not txt_path.exists(): print(f[{split}] 缺少标签: {txt_path.name}) continue lines txt_path.read_text(encodingutf-8).strip().splitlines() if len(lines) 0: print(f[{split}] 空标签: {txt_path.name}) continue for line in lines: parts line.split() if len(parts) ! 5: print(f[{split}] 格式错误: {txt_path.name} - {line}) continue cls_id, x, y, w, h int(parts[0]), *map(float, parts[1:]) if cls_id num_classes: print(f[{split}] 类别越界: {txt_path.name} - class {cls_id}) if not (0 x 1 and 0 y 1 and 0 w 1 and 0 h 1): print(f[{split}] 坐标越界: {txt_path.name} - {line}) for img_path in img_dir.glob(*.jpg): img cv2.imread(str(img_path)) if img is None: print(f[{split}] 图片损坏或无法读取: {img_path.name})这段代码的逻辑是先解析 data.yaml 拿到类别数量然后按划分依次检查每个 split。img_dir Path(cfg[split])拿到图片目录lbl_dir按 YOLO 约定定位到同级 labels 目录。之后逐张检查图片对应的 txt 是否存在、是否为空以及每一行是否满足 5 个字段的格式。最后用cv2.imread验证图片本身能否被 OpenCV 正确解码。参数说明img_dir.parent / labels / img_dir.name这一行的前提是 images 和 labels 在同一父目录下这也是 YOLO 数据集的默认组织方式如果实测发现数据集把 labels 直接放在项目根目录把这里的路径逻辑改成直接指向 labels 目录即可。脚本里的*.jpg只匹配 jpg如果你的数据集里混有 png 或 bmp改成*.png或直接用img_dir.iterdir()过滤后缀。跑完这个脚本如果有输出一条一条改没有输出就可以放心进第 3 章。2.4 改对 data.yaml 的路径绝对路径和相对路径的取舍data.yaml 路径问题是最容易被忽视的坑。YOLOv5 和 YOLOv8 对路径的处理逻辑不太一样v5 里 train/val 直接写绝对路径或相对当前工作目录的相对路径v8 和 yolo11 新增了path字段train/val/test 会基于path去拼接。所以同样一份 data.yaml在 v5 里跑得好好的到 v8 里就报 FileNotFoundError反之亦然。我的建议是统一用相对路径并且把数据集目录放到和工程目录平级的位置约定好相对关系后在 data.yaml 里只用./dataset这种写法。好处是换机器、换项目目录都不用改配置。如果你必须在多台机器间迁移用绝对路径能保证一次跑通但下次换路径就要重新改。一个折中做法是在训练命令里用data/完整/路径/data.yaml覆盖 data.yaml 内的相对路径让配置文件保持通用训练脚本里指定具体位置。提示Windows 上路径分隔符要用正斜杠/不要用D:\dataset这种反斜杠写法YAML 解析会把\d当转义符处理。3. 用 YOLOv8 训练自己的课堂行为检测数据集版本选型、环境与最小命令3.1 三个版本怎么选v5 求稳、v8 默认、yolo11 留给对比实验标题里同时提到了 yolov5、yolov8 和 yolo11训练前先定版本。YOLOv5 是目前中文社区资料最多的版本教程、报错解决方案一搜一大把如果你的运行环境比较老旧、或者要复现别人的实验用 v5 最稳。但 v5 的维护节奏已经放缓新特性基本停在 7.0 版本论文审稿人也可能会问“为什么不用新版本”。YOLOv8 是 Ultralytics 统一框架下的主力版本训练、验证、导出命令完全一致模型定义、预训练权重、数据增广管线都保持同步最适合“训练自己的数据集”这个诉求。YOLO11 是后续版本推理速度和精度在官方评测里有提升但它的模型文件和部分 API 与 v8 不通用目前社区踩坑记录相对少除非你有对比实验的需求否则不建议作为第一次训练的主版本。如果搜教程时看到 yolov26、yolov9 这类命名先确认它是不是 Ultralytics 官方仓库的通用接口。非官方分支的配置文件格式很随意data.yaml 的字段可能都不一样别直接拿来跑这份数据集。3.2 Anaconda 环境配置与 GPU 自检环境配置是新手最容易卡住的环节但 2000 张规模的学生课堂行为检测训练并不需要多复杂的依赖。用 Anaconda 建一个独立环境是常见做法Python 3.10 配合当前主流的 PyTorch 版本即可满足 Ultralytics 框架要求。下面是环境搭建的最小命令。conda create -n yolo python3.10 -y conda activate yolo pip install ultralytics python -c import torch; print(torch.cuda.is_available(), torch.cuda.get_device_name(0))逻辑说明conda create建独立环境避免污染系统 Pythonpip install ultralytics会把 torch、torchvision、opencv 等依赖一并装上最后一行用来确认 PyTorch 是否能识别 GPU。如果输出True NVIDIA GeForce ...说明 CUDA 环境正常。如果最后一行输出False优先检查显卡驱动版本和 CUDA 版本匹配。PyTorch 的 CUDA 版本和显卡驱动是两回事驱动装的是大版本PyTorch 自带的小版本只要驱动支持就能跑。把pip install ultralytics默认装的 CPU 版 torch 卸载去 PyTorch 官网选择对应 CUDA 版本的安装命令重装即可。笔记本用户如果只有集显那就只能 CPU 训练2000 张图会慢很多但也能跑完只是别把 epochs 设太大。3.3 最小训练命令与参数模板8G 显存和 24G 显存怎么配环境就绪后训练命令本身并不复杂。下面是一个针对课堂行为检测数据集的通用模板默认模型用 YOLOv8s在 8G 显存上可以跑得动。yolo train \ modelyolov8s.pt \ data./dataset/data.yaml \ epochs150 \ imgsz640 \ batch16 \ workers4 \ cacheTrue \ patience50 \ projectruns/train \ nameclassroom_baseline逻辑说明modelyolov8s.pt表示用 COCO 预训练权重做迁移学习起点这是 2000 张小规模数据集能训好的关键data指向第 2 章校验过的 data.yamlepochs、batch、imgsz需要配合显存调整workers是数据加载线程数Windows 上建议设为 0 或 2数值太高可能报 DataLoader worker 错误cacheTrue把图片缓存到内存能明显加速小数据集的训练patience50是早停容忍度连续 50 轮验证指标不上升就停止。参数调整要分情况。24G 显存可以改用yolov8m.pt、batch32、imgsz640m 模型比 s 模型参数量大在 2000 张规模下能榨出略高一点的精度但训练时间翻倍。8G 显存如果跑默认批次都 OOM优先把batch降到 8再不行把imgsz降到 480。p.s. imgsz 别低于 416课堂行为检测里的手部、手机这类小目标在低分辨率下会直接消失。epochs150未必真的要跑满。课堂行为这 6 类之间的区分度并不低通常 80 到 120 轮就能收敛后面几十轮基本是在小幅波动。早停触发得早说明验证集指标已经不涨了不用觉得可惜。3.4 训练中断恢复和数据缓存resume 与 cache 的取舍训练跑到一半断电、断网、或者手动 CtrlC 是人类本质。Ultralytics 框架会在每次 epoch 结束时把当前权重存到runs/train/classroom_baseline/weights/last.pt用下面的命令可以从断点继续yolo train resumeTrue \ projectruns/train \ nameclassroom_baselineresume 会自动读取 last.pt 和对应的 args.yaml之前设的 epochs、batch、imgsz 全部沿用不需要重新敲一遍参数。要注意 resume 只对同一个数据集、同一个项目目录有效如果中途改动了 data.yaml 或换了数据集目录resume 会报配置不一致的警告这时候还不如删掉旧 run 重新训。cacheTrue对小数据集性价比很高。2000 张 640 分辨率的 JPEG 缓存到内存大概会占几个 G 的 RAM换来的是一轮训练少等几分钟。如果机器内存紧张或者同时开了多个程序用cachedisk把缓存写到磁盘速度介于内存缓存和不缓存之间。注意 Windows 下cacheTrue偶尔会和某些杀毒软件产生文件读取冲突表现为训练中随机报错这时候把 cache 关掉就能绕过去。4. 训练完别只盯 mAP看 loss 曲线、混淆矩阵和一张实测照片4.1 从 results.csv 读 loss 曲线收敛的三种正常形态两种翻车形态训练结束后Ultralytics 会在runs/train/classroom_baseline/下生成results.csv和results.png里面记录了每一轮的 train loss、val loss、precision、recall、mAP50、mAP50-95。很多人只看最后一行 mAP但我觉得曲线形态更重要它告诉你训练过程是否健康。正常收敛的形态有三种box_loss 和 cls_loss 从高点持续下降后半段趋于平稳不再大幅起伏precision 和 recall 同步爬升中间有抖动但整体向上mAP50 曲线在最后三四十轮保持在一个平台期不再有明显上升。这三种形态任何一种都表示可以停训选 best.pt 即可。两种翻车形态要特别注意。第一种是 loss 在前 20 轮快速下降后突然反弹然后一直在高位震荡这通常是学习率没配合好或者数据里有大量脏标签模型在拟合噪声。第二种是 cls_loss 降得很慢始终比其他类别的 loss 高一个数量级说明某个类别的样本数量太少模型根本没学到该类特征。课堂行为数据集里“睡觉”“玩手机”这类样本数量天然少如果发现这两个类别的 AP 明显低不要急着调模型先去看数据分布。4.2 用混淆矩阵找“互相认错”的类别组合验证集评估完成后ultralytics 会在runs/detect/val/下生成confusion_matrix_normalized.png。这张图是判断类别间相似度的最直接工具横轴是真实类别纵轴是预测类别对角线上的值越接近 1 越好非对角线上的亮点就是模型容易认错的地方。课堂行为检测里最容易互相混淆的组合凭我做过这类项目的经验通常是“低头玩手机”和“睡觉”。这两个动作在 640 分辨率下的上半身姿态接近手机目标又小模型很容易把两者归为一类。其次是“举手”和“阅读/书写”之间的边缘误判举手的瞬间手部轨迹和书本遮挡会让检测器抓错特征。如果混淆矩阵显示某两个类别的混淆严重得不可接受优先检查这批样本的标注质量尤其是边界框是否把相邻的人框进去了。课堂场景座位密集目标框边缘重叠是常态标注时把两个同桌的长框压在一起模型就会学到“这个位置的框就是这两个类之一”。这不是模型的问题是数据的边界问题。4.3 实测一张教室照片误检、漏检和置信度阈值的判断标准训练集和验证集里的结果再漂亮都不如拿一张没见过的教室照片实测来得放心。测试集里的图片虽然没参加训练但和训练集出自同一批采集环境分布高度一致真正考验模型的是换个教室、换个摄像头角度、换一天的光线。我一般会在训练前就预留一小批完全没有参与划分的照片训练后再跑一遍。yolo predict modelruns/train/classroom_baseline/weights/best.pt \ source./test_room.jpg \ saveTrue \ conf0.25conf0.25是置信度阈值低于这个值的检测结果会被过滤掉。实际部署时这个值很值得反复调调低到 0.1 会暴露更多低置信度框召回率上升但误检变多调高到 0.5 则过滤掉大部分误检但也可能把遮挡严重的小目标漏掉。课堂场景里我习惯在演示时用 0.3 左右在正式统计场景用 0.4 以上具体看你要保准确率还是保召回率。判断实测结果时重点看两类错误一类是漏检图片里明显有学生举手但模型没框出来这通常是小目标或密集遮挡问题另一类是误检某个学生的动作被识别成完全不相干的类别这往往是训练数据里没覆盖这个姿态。这两种问题的处理方向不同漏检优先加数据增强、提高 imgsz误检优先检查标注质量和类别定义边界。5. 避坑记录课堂行为数据集训练翻车的 5 个常见问题5.1 换台机器训练就报 FileNotFoundError现象data.yaml 里写的是绝对路径本地训练正常把整个数据集打包到服务器后运行报 FileNotFoundError提示找不到图片目录。原因data.yaml 里 train/val/test 写死了D:/dataset/images/train或/home/user/project/...这类绝对路径。换机器后数据集不在这条路径下训练进程就懵了。解决统一改成相对路径并把path字段设为数据集目录相对于工程根目录的位置。养成“data.yaml 不写绝对路径”的习惯换机器只改一个path字段就够了。5.2 loss 正常下降但 mAP 一直是 0现象训练过程打印的 train loss 一路下降看起来一切正常但 val 阶段 mAP 永远是 0验证集的混淆矩阵也全在横纵坐标等于 background 的格子里。原因标签和图片没有正确配对最常见的是 labels 目录路径写错导致所有样本的标注都读不到另一种可能是标注 txt 里类别 id 全为某个越界值模型预测结果无法和 GT 匹配。解决回头跑一遍第 2.3 节的体检脚本重点看“缺少标签”和“类别越界”两类输出。标签文件存在但内容为空也要怀疑空 txt 会直接拖低一整个 batch 的正样本数量AP 自然上不去。5.3 显存 OOM 或训练到中途被 killed现象启动训练后几秒内报CUDA out of memory或训练到一半进程消失终端没有任何显式报错。原因batch、imgsz 和模型规模超过了显卡显存上限。8G 显存用 yolov8m 加 batch 32 加 imgsz 640OOM 是必然的。被 killed 则要怀疑是内存不足或系统 oom killer 介入。解决按“先降 batch 到 8 → 再降 imgsz 到 480 → 最后换小模型 yolov8n”的优先级顺序调整别一上来就换模型。另外检查workers是否设得过高Windows 上 4 个 worker 可能比 2 个更慢、更耗内存OOM 时优先降 workers。5.4 epochs 没跑完就 EarlyStopping模型欠拟合现象训练跑了 20 多轮就提示早停best.pt 停留在第 5 轮损失曲线明显还在下降阶段。验证集小、样本不均衡、不同 epoch 之间的 val loss 波动大会让早停判定“不涨”从而提前结束造成欠拟合。原因早停机制看验证集指标的“趋势”而不是绝对数值。课堂行为数据集里如果 val 只有一两百张波动抵消真实提升就会被误判。解决把patience调大到 50或直接设patience0关闭早停用固定epochs跑完完整流程后再手动选 best.pt。小数据集上的早停阈值本来就是玄学宁可多跑几十轮也别让它提前收工。5.5 训练集效果不错测试集上框的位置不稳定现象把测试集照片丢进去预测大部分能框对但个别连续帧里同一个学生的框忽大忽小中心点左右漂移。原因训练时用了默认的 mosaic 和随机仿射增强模型对目标位置的学习不够稳定另一个可能原因是 imgsz 太低小目标在 640 分辨率下只有几十像素任何细微变化都会放大到预测框的坐标上。解决训练时固定随机种子seed0验证时把imgsz提到 960 或 1280 重新预测确认是分辨率问题还是模型问题。如果提高分辨率后框稳定了后续训练就改用imgsz960跑代价是显存占用翻倍。6. 把这 2000 张数据用到尽半自动标注、数据增强与 ONNX 导出6.1 用 best.pt 做半自动标注把数据集扩到自己的教室2000 张标注好的数据能让你训出一个不错的 baseline但如果要把它用于自己教室的实测场景数据分布差异会拉低效果——不同教室的摄像头高度、光线、桌子颜色都不同。最省钱的做法是用训练好的模型做半自动标注先调整好模型对当前场景的检测效果然后对教室录制视频抽帧用yolo predict批量生成预测标签再人工修正。yolo predict modelbest.pt source./frames save_txtTrue save_confTrue conf0.35批量预测后每张图会生成同名 txt 和预测置信度用 labelImg 打开这些图保留高置信度且框正确的标注修正低置信度或框偏的标注删掉误检。labelImg 在 Anaconda 环境里pip install labelimg后命令行直接启动注意把保存格式切到 YOLO再补标几十张本教室的照片把新标注的文件合进原始数据集的 train 目录重新训练。6.2 数据增强参数与少数类过采样Ultralytics 默认开启 mosaic、random_hsv、fliplr 等增强对小规模的课堂行为数据集来说已经够用。如果你想再压榨一点精度可以在训练命令里显式控制增广强度hsv_h0.015、hsv_s0.7、hsv_v0.5控制颜色扰动degrees5控制轻微旋转scale0.4控制尺度变化。教室场景不要用太大角度的旋转和透视变换桌椅都是横平竖直的过度增强反而引入伪样本。少数类样本太少是这类数据集的结构性问题增强只能缓解一部分。更直接的做法是把“睡觉”“玩手机”这类样本量少的图片复制一两份放进训练集再配合mosaic1.0让增强器生成更多混合场景。因为复制不会改变真实分布但会把训练时每个 epoch 里该类样本出现的频率拉上均值线类别不平衡引起的 AP 拉垮会改善一些。6.3 把模型转成 ONNX部署到边缘设备训练不是终点能落地才是。模型导出到 ONNX 格式只需一行命令yolo export modelruns/train/classroom_baseline/weights/best.pt \ formatonnx \ imgsz640 \ opset12导出后得到 best.onnx可以直接用 ONNX Runtime 或 TensorRT 部署在教室边缘设备上。opset 保持默认即可除非目标设备的推理库要求特定版本。导出前先确认 imgsz 和训练时一致否则会遇到输入尺寸不匹配的报错。做完这一整轮你的课堂行为检测项目才算真正闭环。我自己每次训练新数据集都会先跑一个 30 轮的烟雾测试确认 loss 在掉、mAP 在涨再挂机跑完整训练——这个习惯已经帮我避开了无数个白跑的晚上。希望帮到你。本文还有配套的精品资源点击获取
