简介这份资源是面向深度学习初学者与安防、体育分析方向开发者的YOLOv8摔倒检测完整代码包用于快速搭建可识别视频或图像中人物摔倒事件的目标检测系统可应用于老年人监护、公共场所安全监控及运动员训练反馈等场景。压缩包为zip格式整体约894.56MB内含训练与推理代码、标注数据集、模型配置文件、预训练权重及数据增强、结果可视化等辅助脚本覆盖从模型定义、数据预处理到损失函数与优化器设置的完整流程。目前已有853人学习下载适合具备一定深度学习基础、希望理解mAP等评估指标并动手调参的读者。借助这份代码读者可对照配置文件理解网络结构与超参数利用权重文件直接推理或微调并参考辅助脚本完成数据增强与预测结果解析从而快速将摔倒检测方案部署到实际应用中。1. 摔倒检测为什么选 YOLOv8从场景痛点到落地方案做养老监护、工地安全、医院病房这类场景的工程师大概率都碰过同一个需求摄像头画面里有人摔倒系统得在几秒内报警。传统做法要么用姿态估计先抽骨架再判角度要么用背景建模加轮廓分析前者依赖关键点精度、后者一遇到光照变化就翻车。YOLOv8 把这件事简化成了一个目标检测问题——把摔倒和未摔倒当成两个类别直接训推理一次出框工程链路短、部署门槛低这也是它在这类项目里被反复选中的原因。这份 YOLOv8 摔倒检测完整代码覆盖的是从数据组织、模型训练到推理落地的整条链路适合两类人一类是刚接触目标检测、想拿一个真实场景跑通全流程的新手另一类是想把摔倒检测塞进自己现有监控系统、需要一份能改能调的基线代码的从业者。它不解决摔倒动作的细粒度分类也不做时序判断单帧检测的边界就在这里后面会专门讲怎么补。2. 环境搭建与数据准备把 YOLOv8 跑起来的前置条件2.1 环境配置CPU 版本也能先跑通很多人卡在第一步不是代码问题是环境。YOLOv8 依赖 ultralytics 这个库它对 PyTorch 版本有要求装错了就是一堆 import 报错。如果你手头只有一台没有独显的机器比如 Ubuntu 20.04 的 CPU 版本照样能跑训练和推理只是慢。我一般会先建一个干净的虚拟环境避免和系统里的其他包打架。# 创建并激活虚拟环境Python 建议 3.8 到 3.10 python -m venv yolov8_env source yolov8_env/bin/activate # Windows 用 yolov8_env\Scripts\activate # 安装 PyTorchCPU 版本走官方 CPU 源 pip install torch torchvision --index-url https://download.pytorch.org/whl/cpu # 安装 ultralytics它会自动带上 opencv、numpy 等依赖 pip install ultralytics这段命令的逻辑是先隔离环境再装 PyTorch 底座最后装 ultralytics。参数上--index-url指定 CPU 版下载源如果你有 NVIDIA 显卡把这一行换成对应 CUDA 版本的官方命令即可比如 cu118。装完用yolo checks验证它会打印出 PyTorch、CUDA 是否可用、以及当前 ultralytics 版本。如果这一步报No module named ultralytics八成是虚拟环境没激活或者 pip 装到了系统 Python 里。提示GTX 1660 Ti 这类 6G 显存的卡跑 YOLOv8n 训练是够的但 batch size 别超过 8否则显存溢出报 CUDA out of memory。2.2 数据集组织摔倒检测的标注与目录结构YOLOv8 认的是 YOLO 格式的标注每张图对应一个 txt每行是类别 中心x 中心y 宽 高坐标都归一化到 0 到 1。摔倒检测一般分两类fall和no_fall也有人把站立、坐下单独拆类但类别越多、样本越难均衡新手建议先两类跑通。标注工具用 Labelme 也行但它默认出的是 JSON得转一道更省事的是直接用 labelImg 或 Roboflow 导出 YOLO 格式。目录结构按下面这样摆ultralytics 才能自动识别fall_dataset/ ├── images/ │ ├── train/ # 训练图片 │ └── val/ # 验证图片 ├── labels/ │ ├── train/ # 对应训练标注 txt │ └── val/ # 对应验证标注 txt └── data.yaml # 数据集配置文件data.yaml是训练入口内容长这样path: ./fall_dataset # 数据集根目录 train: images/train # 训练集相对路径 val: images/val # 验证集相对路径 nc: 2 # 类别数 names: [no_fall, fall] # 类别名顺序要和标注里的类别 id 对上这里最容易踩的坑是类别顺序。标注时fall是 0 还是 1必须和names列表一致否则训练出来的模型会把摔倒识别成没摔倒而且 loss 看着还挺正常属于典型的玄学翻车。我一般会在标注完先抽三张图用脚本把框画出来肉眼核对一遍再开训。2.3 数据增强与样本均衡的取舍摔倒检测的数据集天然不均衡——正常站立、走动的帧远多于摔倒帧。直接训模型会倾向于全预测no_fallmAP 看着不低但真摔倒一个都抓不到。常见做法是在data.yaml同级配一个训练参数文件或者直接在训练命令里加增强参数。YOLOv8 内置了 mosaic、翻转、HSV 抖动这些对摔倒场景有用的主要是随机缩放和水平翻转垂直翻转要慎用因为倒过来的人容易被误判成摔倒。样本层面我一般会把摔倒帧做几倍过采样或者用 copy-paste 把摔倒的人贴到不同背景上。但要注意贴图合成如果边缘处理不好模型会学到贴图痕迹而不是摔倒姿态验证集上虚高、实际场景拉胯。判断方法很简单拿几段没参与训练的监控视频跑推理看漏检和误检比看 mAP 靠谱。3. 模型训练与参数调优从预训练权重到收敛曲线3.1 加载预训练权重开始训练YOLOv8 官方放出了 n、s、m、l、x 五个尺度的预训练权重摔倒检测这种场景n 或 s 就够用模型小、推理快适合边缘设备。训练命令一行就能起# 用 yolov8n 预训练权重在自定义数据集上训练 100 轮 yolo detect train \ datafall_dataset/data.yaml \ modelyolov8n.pt \ epochs100 \ imgsz640 \ batch8 \ lr00.01 \ patience20 \ projectruns/fall \ nameexp1逐项说参数data指向数据集配置model是预训练权重第一次跑会自动下载epochs是训练轮数摔倒数据量小的话 100 轮通常够imgsz是输入尺寸640 是默认值监控画面里人小的话可以提到 960但显存和速度都会涨batch按显存调lr0是初始学习率0.01 是官方推荐起点patience是早停耐心值20 轮验证指标不涨就停省时间。project和name决定结果存哪跑完在runs/fall/exp1/下能看到权重、曲线图和日志。训练过程中重点盯两个东西box_loss和cls_loss是否稳定下降以及验证集的 mAP50 曲线。如果 loss 震荡厉害先把lr0降到 0.001 试试如果 mAP 早早卡住不涨多半是数据问题而不是参数问题。3.2 损失曲线与指标解读跑完训练results.png里会把训练和验证的 loss、precision、recall、mAP 都画出来。摔倒检测最该看的是 recall——漏检一个摔倒的代价远大于误报一次。如果 recall 明显低于 precision说明模型偏保守可以适当降低置信度阈值或者在训练时给fall类加权。YOLOv8 画损失函数曲线图不用自己写代码训练日志里已经存了results.csv想单独画可以用 pandas 加 matplotlibimport pandas as pd import matplotlib.pyplot as plt # 读取训练日志results.csv 在训练输出目录下 df pd.read_csv(runs/fall/exp1/results.csv) df.columns df.columns.str.strip() # 列名可能带空格先清理 plt.figure(figsize(10, 5)) plt.plot(df[epoch], df[train/box_loss], labeltrain box loss) plt.plot(df[epoch], df[val/box_loss], labelval box loss) plt.xlabel(epoch) plt.ylabel(loss) plt.legend() plt.savefig(loss_curve.png, dpi150)这段代码读的是训练输出的 CSV列名里带斜杠pandas 读进来后建议先 strip 一下空格否则取列会报 KeyError。画出来能直观看到训练和验证 loss 是否同步下降如果验证 loss 早早抬头就是过拟合得加数据或加正则。3.3 摔倒检测的置信度与 NMS 参数推理阶段有两个参数直接决定漏检和误检置信度阈值conf和 NMS 的iou。默认conf0.25、iou0.7但摔倒场景我一般会把conf降到 0.15 到 0.2宁可多报也别漏。NMS 的iou在画面里人密集时调低一点比如 0.5避免相邻的人框被合并。# 用训练好的权重做推理降低置信度阈值提高召回 yolo detect predict \ modelruns/fall/exp1/weights/best.pt \ sourcetest_video.mp4 \ conf0.2 \ iou0.5 \ saveTruesource可以是单张图、视频、整个目录甚至摄像头编号。saveTrue会把带框的结果存下来。调参没有万能值得拿实际场景的视频反复试把漏检和误检的片段截出来对比才能定下来。4. 推理部署与常见问题排查4.1 从脚本推理到服务化封装训练完的best.pt要真正用起来得包成能持续处理视频流的服务。最直接的方式是用 OpenCV 读帧逐帧送进模型判断有没有fall类且置信度超阈值超了就触发报警。下面是一个最小可用的推理循环import cv2 from ultralytics import YOLO model YOLO(runs/fall/exp1/weights/best.pt) cap cv2.VideoCapture(test_video.mp4) FALL_CONF 0.5 # 报警阈值比检测阈值高减少误报 while cap.isOpened(): ret, frame cap.read() if not ret: break results model(frame, conf0.2, verboseFalse) for r in results: for box in r.boxes: cls_id int(box.cls[0]) conf float(box.conf[0]) # 类别名从模型里取避免硬编码顺序出错 name model.names[cls_id] if name fall and conf FALL_CONF: x1, y1, x2, y2 map(int, box.xyxy[0]) cv2.rectangle(frame, (x1, y1), (x2, y2), (0, 0, 255), 2) cv2.putText(frame, fFALL {conf:.2f}, (x1, y1 - 10), cv2.FONT_HERSHEY_SIMPLEX, 0.7, (0, 0, 255), 2) cv2.imshow(fall detection, frame) if cv2.waitKey(1) 0xFF ord(q): break cap.release() cv2.destroyAllWindows()逻辑上分三层读帧、推理、判定报警。关键点是报警阈值FALL_CONF和检测阈值分开检测用低阈值保召回报警用高阈值压误报。类别名从model.names取而不是写死数字这样换数据集也不会错位。实际部署时把imshow换成推流或写文件再接一个报警回调就行。4.2 避坑与排查五个真实踩过的坑现象一训练 loss 正常下降但验证集 mAP 一直是 0。原因data.yaml里的names顺序和标注 txt 里的类别 id 对不上或者val路径写错导致验证集为空。 解决先确认labels/val下有对应 txt再抽一张图用脚本把框画出来核对类别路径用绝对路径试一次排除相对路径问题。现象二推理时所有框都标成no_fall摔倒完全不报。原因训练集里摔倒样本太少模型退化成只预测多数类。 解决对摔倒帧过采样或在训练时用cls权重给fall类加权同时把推理conf降到 0.15 观察是否出现摔倒框。现象三CPU 上推理一帧要好几秒视频卡成幻灯片。原因用了yolov8m或更大模型且没做输入尺寸压缩。 解决换yolov8n把imgsz降到 416 或 320或者用 ONNX Runtime 做 CPU 推理加速速度能提升两三倍。现象四白天检测正常晚上红外画面几乎全漏。原因训练数据全是可见光模型没见过红外成像的灰度分布。 解决在训练集里混入夜间红外帧或者对红外画面单独微调一轮别指望一个模型通吃两种成像。现象五相邻两个人挨得近时框被 NMS 合并成一个。原因iou阈值太高重叠框被误判为同一目标。 解决把推理iou降到 0.5 甚至 0.4或者在训练时增加密集人群场景的样本。4.3 单帧检测的边界时序信息怎么补YOLOv8 是单帧检测它判断的是这一帧里有没有摔倒姿态但真实摔倒是一个过程——人从站立到倒地有连续几帧。单帧模型容易把蹲下弯腰捡东西误判成摔倒因为它看不到前后动作。要压这类误报常见做法是加一层时序逻辑连续 N 帧都检测到fall才触发报警或者用简单的跟踪算法给每个人分配 ID看同一个 ID 的姿态是否持续异常。这不是 YOLOv8 本身能解决的但工程上必须补否则误报率会让你在验收时很难受。5. 进阶技巧把摔倒检测推到能交付的程度模型训出来只是起点能不能交付看的是误报率和响应速度。我一般会做三件事。第一件是滑动窗口投票维护一个长度为 10 的队列记录最近 10 帧里fall出现的次数超过 6 次才报警这样偶发的单帧误检会被过滤掉。第二件是区域屏蔽监控画面里有些区域根本不可能有人摔倒比如天花板、走廊尽头用多边形把这些区域标出来框中心落在里面就忽略。第三件是分级报警置信度 0.5 到 0.7 记一次预警超过 0.7 直接报警给值班人员一个缓冲。验证方法上别只看 mAP。找几段真实监控视频人工数出摔倒次数跑一遍系统统计漏检和误报算出实际召回率和误报率这才是能写进验收报告的数字。如果条件允许把模型导出成 ONNX 或 TensorRT在目标设备上测端到端延迟从读帧到报警的总耗时控制在 1 秒内才算真正可用。from collections import deque # 滑动窗口投票过滤单帧误检 history deque(maxlen10) FALL_RATIO 0.6 # 窗口内摔倒帧占比超过这个值才报警 def should_alarm(fall_detected): history.append(1 if fall_detected else 0) if len(history) history.maxlen: return False return sum(history) / len(history) FALL_RATIO这段逻辑很轻但效果立竿见影。maxlen和FALL_RATIO要根据场景帧率调25 帧的视频里 10 帧窗口大概覆盖 0.4 秒够滤掉抖动又不会太迟钝。从那以后我每次做摔倒检测都会先把这套投票逻辑接上再谈模型精度否则单帧模型的误报能把整个系统的可信度拖垮。希望帮到你。本文还有配套的精品资源点击获取