简介本资源面向从事工地安全智能监测的算法工程师与深度学习学习者提供一套可直接用于YOLO系列目标检测训练的安全帽与反光衣数据集帮助解决施工现场人员防护装备识别这一典型工业场景问题。压缩包共含2000个文件以1088个xml标注文件和912个txt标注文件为主分别对应VOC与YOLO两种标签格式整体约193.28MB并附带data.yaml配置文件已划分好训练与验证集适配yolov5、yolov8、yolov9、yolov7、yolov10及yolo11等主流版本。YOLO格式采用类别索引与归一化中心点、宽高坐标便于直接读取训练。目前已有169人学习下载。读者可获得开箱即用的标注数据、双格式标签与配置模板省去自行采集与标注成本快速复现安全帽与反光衣检测实验并在此基础上做模型对比与调优。1. 工地安全帽与反光衣检测1312 张图像的数据集到底能不能撑起一个 YOLO 项目工地出入口的摄像头画面里安全帽和反光衣是最该被盯住的两类目标。传统做法靠安全员盯屏幕一个班次下来眼睛就废了漏检几乎是必然。用 YOLO 做自动检测是这几年最主流的落地路径而真正卡住大多数人的不是模型结构是数据。手里这份「yolo算法-工地安全帽-反光衣数据集-1312张图像带标签」正好切中这个痛点1312 张已经标注好的图像覆盖安全帽和安全帽缺失、反光衣和反光衣缺失这几类目标直接省掉了最耗时的标注环节。它适合两类人一类是想快速跑通 YOLO 训练流程、验证工地场景可行性的算法工程师另一类是手上有工地项目、需要先出一个能演示的检测原型的产品或集成方。1312 张不算多但足够把「数据准备—训练—推理—评估」这条链路完整走一遍也能让你判断这个方向值不值得继续投入更多标注成本。下面我按自己实际跑这类数据集的顺序把每一步的参数和坑讲清楚。2. 从压缩包到可训练数据集目录结构、标签格式与划分脚本拿到一个带标签的图像压缩包第一件事不是急着训练而是先搞清楚它的目录长什么样、标签是什么格式。这一步做错后面训练报的错会让你怀疑人生。2.1 先看清目录结构和标签格式常见的工地安全帽数据集有两种组织方式一种是已经按 YOLO 要求分好images/和labels/另一种是原始图像和 XML/JSON 标注混在一起。1312 张这个量级大概率是前者但也可能是 VOC 格式的 XML。解压后先跑一条命令看结构# 查看解压后的目录层级确认 images 和 labels 是否成对存在 find ./dataset -maxdepth 2 -type d | sort # 统计图像数量确认和标题里的 1312 是否对得上 find ./dataset -name *.jpg -o -name *.png | wc -l # 看一张标签文件的内容判断是 YOLO txt 还是 VOC xml head -n 5 ./dataset/labels/000001.txt 2/dev/null || head -n 20 ./dataset/annotations/000001.xml如果head出来的是类别 x_center y_center width height这种归一化到 0~1 的五列数字那就是标准 YOLO 格式可以直接用。如果是 XML里面是bndbox带xmin/ymin/xmax/ymax像素坐标就需要转换。YOLO 的标签是归一化的中心点加宽高转换公式是x_center(xminxmax)/2/图像宽其余同理。这一步的坑在于不同标注工具导出的类别编号顺序可能不一致安全帽是 0 还是 1必须自己核对否则训练出来的模型会把类别搞反。2.2 类别映射与 data.yaml 的写法YOLO 训练靠一个data.yaml告诉它去哪找图、有几类、类名是什么。工地场景一般四类helmet戴安全帽、no_helmet未戴、vest穿反光衣、no_vest未穿。但很多数据集只标了「安全帽」和「人」两类反光衣是另外标的需要你合并。写data.yaml时路径用绝对路径最稳相对路径在不同版本里解析基准不一样容易翻车。# data.yamlYOLO 训练的数据配置 path: /home/user/dataset # 数据集根目录绝对路径 train: images/train # 训练集图像目录相对 path val: images/val # 验证集图像目录 nc: 4 # 类别数量必须和标签里的最大类别编号1 一致 names: # 类别名顺序必须和标签编号对应 0: helmet 1: no_helmet 2: vest 3: no_vestnc这个参数最容易出错。如果标签里出现了编号 3而nc写成 3训练会直接报索引越界。判断方法很简单把所有标签文件的第一个字段取出来求最大值加一就是nc。类别名顺序也要和编号严格对应写反了模型能训但推理结果全错这种错误在评估指标上不一定看得出来属于典型的玄学问题。2.3 用脚本做训练集/验证集划分1312 张如果全拿去训练没有验证集就无法判断过拟合。常规做法是 8:1:1 或 8:2 划分。我一般写个小脚本按文件名随机划分保证图像和标签同步移动避免出现「图在训练集、标签在验证集」这种低级错误。import os, random, shutil random.seed(42) # 固定随机种子保证每次划分一致方便复现 img_dir ./dataset/images lbl_dir ./dataset/labels out_root ./dataset_split ratio (0.8, 0.2) # 训练:验证 files [f for f in os.listdir(img_dir) if f.endswith((.jpg, .png))] random.shuffle(files) n_train int(len(files) * ratio[0]) splits {train: files[:n_train], val: files[n_train:]} for split, items in splits.items(): os.makedirs(f{out_root}/images/{split}, exist_okTrue) os.makedirs(f{out_root}/labels/{split}, exist_okTrue) for f in items: stem os.path.splitext(f)[0] shutil.copy(f{img_dir}/{f}, f{out_root}/images/{split}/{f}) # 标签可能不存在纯背景图存在才复制 lbl f{lbl_dir}/{stem}.txt if os.path.exists(lbl): shutil.copy(lbl, f{out_root}/labels/{split}/{stem}.txt)random.seed(42)是为了让划分可复现团队协作时别人拿到同样的种子能得到同样的划分。ratio按需调整1312 张的话验证集 260 张左右够用。注意有些图像可能没有对应标签文件纯背景负样本脚本里做了存在性判断否则会直接抛异常中断。划分完再统计一次两边数量确认加起来等于 1312少一张都说明有文件被漏掉。3. 用 YOLOv8 在 1312 张图上跑通训练环境、命令与关键参数数据准备好之后训练本身反而是最标准化的环节。但 1312 张这个量级有它的特殊性太少容易过拟合太多轮次又没必要参数得针对性调。3.1 环境搭建与预训练权重选择YOLOv8 通过 ultralytics 包安装一条命令搞定。工地场景属于通用目标检测的细分直接用 COCO 预训练权重做迁移学习比从头训练收敛快得多小数据集上这是必须的。# 创建独立环境避免和系统里的 torch 版本冲突 conda create -n yolo_site python3.10 -y conda activate yolo_site # 安装 ultralytics会自动带上匹配的 torch pip install ultralytics # 验证安装能打印版本号就说明环境没问题 yolo version预训练权重用yolov8n.pt或yolov8s.pt。n 是最小的速度快适合先验证流程s 精度略高1312 张上两者差距不会特别大。权重文件第一次运行会自动下载到当前目录如果网络受限需要提前手动放到工作目录。这里不展开下载渠道按官方文档给的地址获取即可。选 n 还是 s 的判断标准如果目标是实时检测比如工地摄像头 25fps优先 n如果只做离线抽帧分析用 s 换一点精度。3.2 训练命令与参数逐项说明训练用yolo detect train子命令核心参数就那么几个但每个都影响结果。yolo detect train \ data./data.yaml \ # 数据配置指向上一章写的 yaml modelyolov8n.pt \ # 预训练权重迁移学习起点 epochs100 \ # 训练轮次小数据集 100 足够多了过拟合 imgsz640 \ # 输入分辨率640 是速度和精度的平衡点 batch16 \ # 批大小显存不够就降到 8 或 4 lr00.01 \ # 初始学习率迁移学习常用 0.01 patience20 \ # 20 轮指标不提升就早停省时间 project./runs \ # 结果输出目录 namehelmet_vest # 本次实验名方便区分多次训练epochs100配合patience20是常见组合早停机制会在验证指标连续 20 轮不提升时自动停止避免无效计算。imgsz640是 YOLO 系列的默认值工地目标人和帽子在画面里通常不会太小640 够用如果摄像头架得远、目标只占几十像素可以提到 1280但显存和耗时都会涨。batch16在 8G 显存上跑 640 分辨率基本没问题报 OOM 就往下调。lr00.01是迁移学习的经验值从头训练才需要更小的学习率。训练过程中重点看mAP50和mAP50-95两个指标前者是 IoU 阈值 0.5 下的平均精度后者更严格。工地场景里no_helmet这类「缺失」类别往往比helmet难检因为负样本形态差异大如果某一类 mAP 明显偏低优先补这类样本。3.3 训练过程怎么看、什么时候该停训练日志里每轮会打印 box_loss、cls_loss 和验证指标。正常情况 loss 持续下降、mAP 持续上升到某个点后 mAP 不再涨、loss 也不再降就是收敛了。如果训练 loss 一直降但验证 mAP 开始掉那是过拟合的典型信号早停会帮你截住。1312 张的数据量通常 50~80 轮就能收敛跑满 100 轮还没动静要么是学习率不对要么是数据标签有问题。我习惯在训练时另开一个终端看 GPU 占用nvidia-smi里显存占满但利用率长期低于 30%说明数据加载是瓶颈可以调大workers参数默认 8机械硬盘上反而要调小。4. 推理、评估与部署前必须验证的几件事训练完得到一个best.pt别急着上线先在验证集和几张真实场景图上跑一遍确认它不是「只会在训练集上表演」。4.1 用验证集跑评估看真实指标# 在验证集上评估输出各类别的 mAP、precision、recall yolo detect val \ model./runs/helmet_vest/weights/best.pt \ data./data.yaml \ imgsz640 \ batch16输出里会按类别列出指标。重点看no_helmet和no_vest的 recall召回率漏检一个没戴安全帽的人比误报一个戴了的人后果严重得多。如果 recall 偏低说明模型对「缺失」这类目标不够敏感解决办法是增加这类负样本或者在推理时降低置信度阈值。precision 低则是误报多工地场景里误报太多会让安全员麻木同样要控制。这两者需要权衡没有绝对标准看你的业务能接受哪种错误。4.2 单张图和视频推理的命令# 单张图推理saveTrue 会把带框的结果存下来 yolo detect predict \ model./runs/helmet_vest/weights/best.pt \ source./test_site.jpg \ conf0.4 \ # 置信度阈值低于此值不输出 iou0.5 \ # NMS 的 IoU 阈值控制重叠框合并 saveTrue # 视频推理逐帧检测后合成输出视频 yolo detect predict \ model./runs/helmet_vest/weights/best.pt \ source./site_clip.mp4 \ conf0.4 \ saveTrueconf0.4是常用的起点工地场景如果漏检多就降到 0.25误报多就提到 0.5。iou0.5控制非极大值抑制人多拥挤时框容易重叠这个值调小会让重叠框保留更多调大则合并更激进。视频推理的耗时和帧率、分辨率直接相关1312 张训出来的模型在 1080p 视频上用 n 权重单卡大概能跑到实时具体看硬件。4.3 部署前的边界检查上线前至少确认三件事一是模型在夜间或逆光画面上的表现工地照明条件差训练集里如果全是白天图晚上大概率翻车二是小目标远处的人和安全帽在画面里可能只有二三十像素640 分辨率下容易漏三是类别混淆反光衣和安全帽颜色相近时可能互相误判。这些都不是训练参数能解决的只能靠补充对应场景的数据。1312 张作为起步够用但要真正上线通常需要按这些边界场景再补几百张。5. 避坑与排查1312 张数据集训练时最容易踩的五个坑这一章是我自己跑这类数据集时踩过的坑按「现象 → 原因 → 解决」写遇到问题可以对照排查。坑一训练报Label class X exceeds nc。现象是训练刚启动就崩提示类别编号超出范围。原因是data.yaml里的nc小于标签文件里实际出现的最大类别编号。解决方法是遍历所有标签文件取第一个字段的最大值nc设为该值加一别凭感觉填。坑二mAP 一直是 0 或者极低。现象是训练能跑完但验证指标惨不忍睹。原因通常是标签格式不对比如把 VOC 的像素坐标直接当成 YOLO 的归一化坐标用了坐标值大于 1模型根本学不到东西。解决方法是抽查几张标签确认所有坐标都在 0~1 之间宽高不为 0。另一个可能是图像和标签文件名没对上YOLO 靠文件名匹配0001.jpg必须对应0001.txt。坑三某一类 recall 特别低。现象是helmet检得很好no_helmet几乎检不出。原因是「缺失」类样本太少或者标注时把没戴帽子的头部漏标了。解决方法是统计各类别框数量对样本少的类做补充标注或过采样也可以在训练时给这类更高的损失权重。坑四显存爆了CUDA out of memory。现象是训练中途报 OOM。原因是batch或imgsz太大。解决方法是先把batch减半还不行就降imgsz到 416 或 320或者用更小的 n 权重。别硬扛小数据集上 batch 从 16 降到 8 对最终精度影响很小。坑五验证集指标很好实际场景一塌糊涂。现象是 mAP 0.9 以上拿到工地视频里却频繁漏检误检。原因是训练集和实际场景分布不一致比如训练集都是正面清晰图实际是俯视、遮挡、夜间。解决方法是按实际场景补数据或者用实际场景的图做一次微调。这是最隐蔽的坑指标好看不代表能用一定要拿真实素材验证。6. 把 1312 张用出更大价值数据增强与增量迭代的具体技巧1312 张的局限在于场景覆盖有限但通过合理的数据增强和增量迭代能把它用出接近几千张的效果。我一般不会一上来就堆增强而是先跑一版基线看模型在哪些场景上弱再针对性补。数据增强方面YOLO 训练时默认开启了 mosaic、HSV 抖动、随机翻转等。工地场景里mosaic 能提升小目标检测但会让图像边缘出现拼接痕迹如果实际场景没有这种分布可以适当降低mosaic的概率。HSV 抖动对光照变化有帮助工地白天黑夜光照差异大把hsv_v亮度抖动调大一点能提升鲁棒性。翻转要注意水平翻转对安全帽检测没问题但垂直翻转会让「戴帽子」变成不自然的姿态一般不开。# 在训练命令里覆盖默认增强参数 yolo detect train \ data./data.yaml \ modelyolov8n.pt \ epochs100 \ imgsz640 \ hsv_v0.5 \ # 亮度抖动幅度默认 0.4工地场景可加大 mosaic0.8 \ # mosaic 概率默认 1.0边缘拼接明显时降到 0.8 fliplr0.5 \ # 水平翻转概率保持默认 flipud0.0 # 垂直翻转关闭避免不自然姿态增量迭代的思路是第一版模型上线后把误检和漏检的帧截下来人工修正标签加入训练集重新训练。这样每迭代一轮模型就更贴近你的实际场景。1312 张作为起点迭代两三轮后通常能到两三千张的有效规模指标会有明显提升。关键是建立这个「推理—收集 badcase—标注—重训」的闭环而不是指望一次训练就完美。最后说个我自己的习惯每次训练前把data.yaml、训练命令、随机种子记在一个文本文件里和权重放一起。过两个月回头看没有这份记录你根本想不起来当时是怎么跑出这个模型的。数据集和模型都会迭代可复现的记录才是后悔药。希望帮到你。本文还有配套的精品资源点击获取 基于1312张图像数据集的YOLO工地安全帽与反光衣检测实战
简介本资源面向从事工地安全智能监测的算法工程师与深度学习学习者提供一套可直接用于YOLO系列目标检测训练的安全帽与反光衣数据集帮助解决施工现场人员防护装备识别这一典型工业场景问题。压缩包共含2000个文件以1088个xml标注文件和912个txt标注文件为主分别对应VOC与YOLO两种标签格式整体约193.28MB并附带data.yaml配置文件已划分好训练与验证集适配yolov5、yolov8、yolov9、yolov7、yolov10及yolo11等主流版本。YOLO格式采用类别索引与归一化中心点、宽高坐标便于直接读取训练。目前已有169人学习下载。读者可获得开箱即用的标注数据、双格式标签与配置模板省去自行采集与标注成本快速复现安全帽与反光衣检测实验并在此基础上做模型对比与调优。1. 工地安全帽与反光衣检测1312 张图像的数据集到底能不能撑起一个 YOLO 项目工地出入口的摄像头画面里安全帽和反光衣是最该被盯住的两类目标。传统做法靠安全员盯屏幕一个班次下来眼睛就废了漏检几乎是必然。用 YOLO 做自动检测是这几年最主流的落地路径而真正卡住大多数人的不是模型结构是数据。手里这份「yolo算法-工地安全帽-反光衣数据集-1312张图像带标签」正好切中这个痛点1312 张已经标注好的图像覆盖安全帽和安全帽缺失、反光衣和反光衣缺失这几类目标直接省掉了最耗时的标注环节。它适合两类人一类是想快速跑通 YOLO 训练流程、验证工地场景可行性的算法工程师另一类是手上有工地项目、需要先出一个能演示的检测原型的产品或集成方。1312 张不算多但足够把「数据准备—训练—推理—评估」这条链路完整走一遍也能让你判断这个方向值不值得继续投入更多标注成本。下面我按自己实际跑这类数据集的顺序把每一步的参数和坑讲清楚。2. 从压缩包到可训练数据集目录结构、标签格式与划分脚本拿到一个带标签的图像压缩包第一件事不是急着训练而是先搞清楚它的目录长什么样、标签是什么格式。这一步做错后面训练报的错会让你怀疑人生。2.1 先看清目录结构和标签格式常见的工地安全帽数据集有两种组织方式一种是已经按 YOLO 要求分好images/和labels/另一种是原始图像和 XML/JSON 标注混在一起。1312 张这个量级大概率是前者但也可能是 VOC 格式的 XML。解压后先跑一条命令看结构# 查看解压后的目录层级确认 images 和 labels 是否成对存在 find ./dataset -maxdepth 2 -type d | sort # 统计图像数量确认和标题里的 1312 是否对得上 find ./dataset -name *.jpg -o -name *.png | wc -l # 看一张标签文件的内容判断是 YOLO txt 还是 VOC xml head -n 5 ./dataset/labels/000001.txt 2/dev/null || head -n 20 ./dataset/annotations/000001.xml如果head出来的是类别 x_center y_center width height这种归一化到 0~1 的五列数字那就是标准 YOLO 格式可以直接用。如果是 XML里面是bndbox带xmin/ymin/xmax/ymax像素坐标就需要转换。YOLO 的标签是归一化的中心点加宽高转换公式是x_center(xminxmax)/2/图像宽其余同理。这一步的坑在于不同标注工具导出的类别编号顺序可能不一致安全帽是 0 还是 1必须自己核对否则训练出来的模型会把类别搞反。2.2 类别映射与 data.yaml 的写法YOLO 训练靠一个data.yaml告诉它去哪找图、有几类、类名是什么。工地场景一般四类helmet戴安全帽、no_helmet未戴、vest穿反光衣、no_vest未穿。但很多数据集只标了「安全帽」和「人」两类反光衣是另外标的需要你合并。写data.yaml时路径用绝对路径最稳相对路径在不同版本里解析基准不一样容易翻车。# data.yamlYOLO 训练的数据配置 path: /home/user/dataset # 数据集根目录绝对路径 train: images/train # 训练集图像目录相对 path val: images/val # 验证集图像目录 nc: 4 # 类别数量必须和标签里的最大类别编号1 一致 names: # 类别名顺序必须和标签编号对应 0: helmet 1: no_helmet 2: vest 3: no_vestnc这个参数最容易出错。如果标签里出现了编号 3而nc写成 3训练会直接报索引越界。判断方法很简单把所有标签文件的第一个字段取出来求最大值加一就是nc。类别名顺序也要和编号严格对应写反了模型能训但推理结果全错这种错误在评估指标上不一定看得出来属于典型的玄学问题。2.3 用脚本做训练集/验证集划分1312 张如果全拿去训练没有验证集就无法判断过拟合。常规做法是 8:1:1 或 8:2 划分。我一般写个小脚本按文件名随机划分保证图像和标签同步移动避免出现「图在训练集、标签在验证集」这种低级错误。import os, random, shutil random.seed(42) # 固定随机种子保证每次划分一致方便复现 img_dir ./dataset/images lbl_dir ./dataset/labels out_root ./dataset_split ratio (0.8, 0.2) # 训练:验证 files [f for f in os.listdir(img_dir) if f.endswith((.jpg, .png))] random.shuffle(files) n_train int(len(files) * ratio[0]) splits {train: files[:n_train], val: files[n_train:]} for split, items in splits.items(): os.makedirs(f{out_root}/images/{split}, exist_okTrue) os.makedirs(f{out_root}/labels/{split}, exist_okTrue) for f in items: stem os.path.splitext(f)[0] shutil.copy(f{img_dir}/{f}, f{out_root}/images/{split}/{f}) # 标签可能不存在纯背景图存在才复制 lbl f{lbl_dir}/{stem}.txt if os.path.exists(lbl): shutil.copy(lbl, f{out_root}/labels/{split}/{stem}.txt)random.seed(42)是为了让划分可复现团队协作时别人拿到同样的种子能得到同样的划分。ratio按需调整1312 张的话验证集 260 张左右够用。注意有些图像可能没有对应标签文件纯背景负样本脚本里做了存在性判断否则会直接抛异常中断。划分完再统计一次两边数量确认加起来等于 1312少一张都说明有文件被漏掉。3. 用 YOLOv8 在 1312 张图上跑通训练环境、命令与关键参数数据准备好之后训练本身反而是最标准化的环节。但 1312 张这个量级有它的特殊性太少容易过拟合太多轮次又没必要参数得针对性调。3.1 环境搭建与预训练权重选择YOLOv8 通过 ultralytics 包安装一条命令搞定。工地场景属于通用目标检测的细分直接用 COCO 预训练权重做迁移学习比从头训练收敛快得多小数据集上这是必须的。# 创建独立环境避免和系统里的 torch 版本冲突 conda create -n yolo_site python3.10 -y conda activate yolo_site # 安装 ultralytics会自动带上匹配的 torch pip install ultralytics # 验证安装能打印版本号就说明环境没问题 yolo version预训练权重用yolov8n.pt或yolov8s.pt。n 是最小的速度快适合先验证流程s 精度略高1312 张上两者差距不会特别大。权重文件第一次运行会自动下载到当前目录如果网络受限需要提前手动放到工作目录。这里不展开下载渠道按官方文档给的地址获取即可。选 n 还是 s 的判断标准如果目标是实时检测比如工地摄像头 25fps优先 n如果只做离线抽帧分析用 s 换一点精度。3.2 训练命令与参数逐项说明训练用yolo detect train子命令核心参数就那么几个但每个都影响结果。yolo detect train \ data./data.yaml \ # 数据配置指向上一章写的 yaml modelyolov8n.pt \ # 预训练权重迁移学习起点 epochs100 \ # 训练轮次小数据集 100 足够多了过拟合 imgsz640 \ # 输入分辨率640 是速度和精度的平衡点 batch16 \ # 批大小显存不够就降到 8 或 4 lr00.01 \ # 初始学习率迁移学习常用 0.01 patience20 \ # 20 轮指标不提升就早停省时间 project./runs \ # 结果输出目录 namehelmet_vest # 本次实验名方便区分多次训练epochs100配合patience20是常见组合早停机制会在验证指标连续 20 轮不提升时自动停止避免无效计算。imgsz640是 YOLO 系列的默认值工地目标人和帽子在画面里通常不会太小640 够用如果摄像头架得远、目标只占几十像素可以提到 1280但显存和耗时都会涨。batch16在 8G 显存上跑 640 分辨率基本没问题报 OOM 就往下调。lr00.01是迁移学习的经验值从头训练才需要更小的学习率。训练过程中重点看mAP50和mAP50-95两个指标前者是 IoU 阈值 0.5 下的平均精度后者更严格。工地场景里no_helmet这类「缺失」类别往往比helmet难检因为负样本形态差异大如果某一类 mAP 明显偏低优先补这类样本。3.3 训练过程怎么看、什么时候该停训练日志里每轮会打印 box_loss、cls_loss 和验证指标。正常情况 loss 持续下降、mAP 持续上升到某个点后 mAP 不再涨、loss 也不再降就是收敛了。如果训练 loss 一直降但验证 mAP 开始掉那是过拟合的典型信号早停会帮你截住。1312 张的数据量通常 50~80 轮就能收敛跑满 100 轮还没动静要么是学习率不对要么是数据标签有问题。我习惯在训练时另开一个终端看 GPU 占用nvidia-smi里显存占满但利用率长期低于 30%说明数据加载是瓶颈可以调大workers参数默认 8机械硬盘上反而要调小。4. 推理、评估与部署前必须验证的几件事训练完得到一个best.pt别急着上线先在验证集和几张真实场景图上跑一遍确认它不是「只会在训练集上表演」。4.1 用验证集跑评估看真实指标# 在验证集上评估输出各类别的 mAP、precision、recall yolo detect val \ model./runs/helmet_vest/weights/best.pt \ data./data.yaml \ imgsz640 \ batch16输出里会按类别列出指标。重点看no_helmet和no_vest的 recall召回率漏检一个没戴安全帽的人比误报一个戴了的人后果严重得多。如果 recall 偏低说明模型对「缺失」这类目标不够敏感解决办法是增加这类负样本或者在推理时降低置信度阈值。precision 低则是误报多工地场景里误报太多会让安全员麻木同样要控制。这两者需要权衡没有绝对标准看你的业务能接受哪种错误。4.2 单张图和视频推理的命令# 单张图推理saveTrue 会把带框的结果存下来 yolo detect predict \ model./runs/helmet_vest/weights/best.pt \ source./test_site.jpg \ conf0.4 \ # 置信度阈值低于此值不输出 iou0.5 \ # NMS 的 IoU 阈值控制重叠框合并 saveTrue # 视频推理逐帧检测后合成输出视频 yolo detect predict \ model./runs/helmet_vest/weights/best.pt \ source./site_clip.mp4 \ conf0.4 \ saveTrueconf0.4是常用的起点工地场景如果漏检多就降到 0.25误报多就提到 0.5。iou0.5控制非极大值抑制人多拥挤时框容易重叠这个值调小会让重叠框保留更多调大则合并更激进。视频推理的耗时和帧率、分辨率直接相关1312 张训出来的模型在 1080p 视频上用 n 权重单卡大概能跑到实时具体看硬件。4.3 部署前的边界检查上线前至少确认三件事一是模型在夜间或逆光画面上的表现工地照明条件差训练集里如果全是白天图晚上大概率翻车二是小目标远处的人和安全帽在画面里可能只有二三十像素640 分辨率下容易漏三是类别混淆反光衣和安全帽颜色相近时可能互相误判。这些都不是训练参数能解决的只能靠补充对应场景的数据。1312 张作为起步够用但要真正上线通常需要按这些边界场景再补几百张。5. 避坑与排查1312 张数据集训练时最容易踩的五个坑这一章是我自己跑这类数据集时踩过的坑按「现象 → 原因 → 解决」写遇到问题可以对照排查。坑一训练报Label class X exceeds nc。现象是训练刚启动就崩提示类别编号超出范围。原因是data.yaml里的nc小于标签文件里实际出现的最大类别编号。解决方法是遍历所有标签文件取第一个字段的最大值nc设为该值加一别凭感觉填。坑二mAP 一直是 0 或者极低。现象是训练能跑完但验证指标惨不忍睹。原因通常是标签格式不对比如把 VOC 的像素坐标直接当成 YOLO 的归一化坐标用了坐标值大于 1模型根本学不到东西。解决方法是抽查几张标签确认所有坐标都在 0~1 之间宽高不为 0。另一个可能是图像和标签文件名没对上YOLO 靠文件名匹配0001.jpg必须对应0001.txt。坑三某一类 recall 特别低。现象是helmet检得很好no_helmet几乎检不出。原因是「缺失」类样本太少或者标注时把没戴帽子的头部漏标了。解决方法是统计各类别框数量对样本少的类做补充标注或过采样也可以在训练时给这类更高的损失权重。坑四显存爆了CUDA out of memory。现象是训练中途报 OOM。原因是batch或imgsz太大。解决方法是先把batch减半还不行就降imgsz到 416 或 320或者用更小的 n 权重。别硬扛小数据集上 batch 从 16 降到 8 对最终精度影响很小。坑五验证集指标很好实际场景一塌糊涂。现象是 mAP 0.9 以上拿到工地视频里却频繁漏检误检。原因是训练集和实际场景分布不一致比如训练集都是正面清晰图实际是俯视、遮挡、夜间。解决方法是按实际场景补数据或者用实际场景的图做一次微调。这是最隐蔽的坑指标好看不代表能用一定要拿真实素材验证。6. 把 1312 张用出更大价值数据增强与增量迭代的具体技巧1312 张的局限在于场景覆盖有限但通过合理的数据增强和增量迭代能把它用出接近几千张的效果。我一般不会一上来就堆增强而是先跑一版基线看模型在哪些场景上弱再针对性补。数据增强方面YOLO 训练时默认开启了 mosaic、HSV 抖动、随机翻转等。工地场景里mosaic 能提升小目标检测但会让图像边缘出现拼接痕迹如果实际场景没有这种分布可以适当降低mosaic的概率。HSV 抖动对光照变化有帮助工地白天黑夜光照差异大把hsv_v亮度抖动调大一点能提升鲁棒性。翻转要注意水平翻转对安全帽检测没问题但垂直翻转会让「戴帽子」变成不自然的姿态一般不开。# 在训练命令里覆盖默认增强参数 yolo detect train \ data./data.yaml \ modelyolov8n.pt \ epochs100 \ imgsz640 \ hsv_v0.5 \ # 亮度抖动幅度默认 0.4工地场景可加大 mosaic0.8 \ # mosaic 概率默认 1.0边缘拼接明显时降到 0.8 fliplr0.5 \ # 水平翻转概率保持默认 flipud0.0 # 垂直翻转关闭避免不自然姿态增量迭代的思路是第一版模型上线后把误检和漏检的帧截下来人工修正标签加入训练集重新训练。这样每迭代一轮模型就更贴近你的实际场景。1312 张作为起点迭代两三轮后通常能到两三千张的有效规模指标会有明显提升。关键是建立这个「推理—收集 badcase—标注—重训」的闭环而不是指望一次训练就完美。最后说个我自己的习惯每次训练前把data.yaml、训练命令、随机种子记在一个文本文件里和权重放一起。过两个月回头看没有这份记录你根本想不起来当时是怎么跑出这个模型的。数据集和模型都会迭代可复现的记录才是后悔药。希望帮到你。本文还有配套的精品资源点击获取