简介基于YOLOv8的智能门禁系统是一套可直接运行的毕设/课设完整项目面向计算机视觉、人工智能、自动化等专业学生和需要快速搭建目标检测应用的初学者覆盖数据准备、模型训练、可视化界面与部署验证的完整流程。压缩包共97个文件以70个Python源码文件为主另含4个模型权重pt文件、配置文件xml、说明文档txt及演示视频mp4整体约24.21MB目录按功能模块划分配合README可快速复现。目前已有52人学习下载。项目内置可视化交互界面和独立训练模块运行后可自动产出混淆矩阵、F1分数曲线、精确率-召回率曲线、验证集预测结果与标签分布图等关键指标便于系统评估模型效果和答辩展示。同时提供YOLOv8n与YOLO11n两套权重适应不同精度/速度需求也可基于此扩展其他视觉检测场景是一份拿来即用的完整解决方案。1. 拿 YOLOv8 做智能门禁先认清楚这个系统到底在检测什么很多同学拿到《基于YOLOv8的智能门禁系统》这个题目第一反应是“做人脸识别”然后就往 FaceNet、ArcFace 方向去查资料结果发现 YOLOv8 的权重里压根没有“人脸特征提取”这一步。这里先给一个反直觉的结论YOLOv8 在门禁系统里的核心职责是“目标检测”也就是解决“门前面有没有人、人在哪个位置、是不是靠近门禁区域”这个物理问题真正决定开门不开门的是检测到人之后你写的业务逻辑而不是模型本身。这类项目在毕设和课设里最常见的使用方式是用 YOLOv8 训练一个单类或多类检测器检测“人”“人脸”甚至“口罩”这些目标然后把检测结果送给上位机界面或单片机做闸机控制。仓库里所带的源码、完整数据集、可视化界面、部署教程解决的就是从“模型训练”到“界面联动”的整条链路。它适合的读者包括两类一是计算机视觉或物联网方向的毕业生需要一套能跑通、能答辩、能演示的完整系统二是想快速落地一个室内考勤或实验室门禁 demo 的工程师手头有摄像头但不想自己从头搓数据集和标注工具。这一章先把坐标系摆正YOLOv8 负责的检测任务、门禁设备负责的开锁任务中间隔着“规则判断”这一步而数据集和可视化界面是把这个判断做得“看起来像产品”的两个关键拼图。后面所有章节都围绕这条链路展开。2. 数据集才是这个系统的天花板从标注格式到类别分布门禁系统的模型效果不好十有八九不是网络结构的问题而是数据集没做好。YOLOv8 训练需要的是标准的 txt 标注文件每张图片对应一个同名 txt每一行是类别id x_center y_center width height这四个坐标值都是相对于图片宽高的归一化浮点数。这是整个数据准备阶段最核心的认知后面的脚本和工具都是围绕这个格式转的。2.1 门禁场景的数据应该拍什么、标什么常见的门禁数据采集场景在毕设里其实不难模拟手持摄像头或手机拍实验室门口、宿舍门口、教学楼门厅覆盖几个关键姿态——正面走向门口、侧面经过、背对摄像头刷卡、多人并排、一人弯腰系鞋带或推门。每个姿态拍 50 到 100 张按不同光照和时间段白天顺光、傍晚逆光、晚上灯光重复一轮凑到 800 到 1500 张图作为训练集比较合适。别贪多先跑通流程再扩数据。标注类别根据你要做的门禁逻辑决定。如果只是“有人靠近就触发人脸比对”那只需一个person类如果要做“先检测人再检测人脸去对齐”那就需要person和face两个类别。很多毕设把类别做成三个person、face、mask这本身没问题但要注意后两类的小目标标注非常耗时而且容易标歪。我的建议是第一版只标person单类把门禁逻辑跑通后再考虑扩充face类做近距离复核。2.2 把 Labelme 的 JSON 批量转成 YOLO 的 TXT一个脚本抄作业Labelme 标注产出的是 JSON 文件里面存的是多边形的逐点坐标格式和 YOLO 的归一化中心点宽高不一样。手工去算坐标不现实必须脚本转换。我一般会在项目根目录建tools/文件夹放下面这个脚本import json import os from pathlib import Path def convert_labelme_json_to_yolo(json_path, class_name_to_id, target_dir): 转换单个 Labelme JSON 文件为 YOLO txt 标注 json_path: labelme 标注文件路径 class_name_to_id: 类别名到 id 的映射例如 {person: 0} target_dir: 输出 txt 的目录 with open(json_path, encodingutf-8) as f: data json.load(f) img_w data[imageWidth] img_h data[imageHeight] lines [] for shape in data[shapes]: label shape[label] if label not in class_name_to_id: continue points shape[points] # [[x1,y1], [x2,y2], ...] xs [p[0] for p in points] ys [p[1] for p in points] x_min, x_max min(xs), max(xs) y_min, y_max min(ys), max(ys) # 防止边缘标成 0 或 1YOLO 训练时边界坐标会有问题 x_min max(0, x_min) y_min max(0, y_min) x_max min(img_w, x_max) y_max min(img_h, y_max) box_w x_max - x_min box_h y_max - y_min if box_w 1 or box_h 1: continue # 跳过无效小框 x_center (x_min x_max) / 2.0 / img_w y_center (y_min y_max) / 2.0 / img_h norm_w box_w / img_w norm_h box_h / img_h lines.append(f{class_name_to_id[label]} {x_center:.6f} {y_center:.6f} {norm_w:.6f} {norm_h:.6f}) out_txt target_dir / (Path(json_path).stem .txt) with open(out_txt, w, encodingutf-8) as f: f.write(\n.join(lines)) def batch_convert(json_dir, txt_dir, class_name_to_id): json_dir Path(json_dir) txt_dir Path(txt_dir) txt_dir.mkdir(parentsTrue, exist_okTrue) for json_file in json_dir.glob(*.json): convert_labelme_json_to_yolo(json_file, class_name_to_id, txt_dir) print(fconverted: {json_file.name}) if __name__ __main__: batch_convert( json_dirdatasets/labelme_annotations, txt_dirdatasets/annotations_txt, class_name_to_id{person: 0} )这个脚本做的事情很直接读 JSON → 取多边形的外接矩形 → 转成归一化的中心点宽高 → 写 txt。参数class_name_to_id是项目里必须手工对齐的地方如果后续新增了face类需要在映射字典里同步加face: 1。脚本里if box_w 1 or box_h 1这行是玄学很多像素级的手滑标注会导致框退化成线不跳过的话模型训练时会反复报空标签警告。转换完成后建议用可视化脚本把矩形框画回原图抽查 20 张确认没有错位这一步不能省。2.3 用 COCO 的 person 类做底料省时间的公开数据集合并策略自己拍 1000 张图对毕设来说压力不小常见做法是把公开数据集里的 person 目标筛出来并入训练集。COCO 数据集的 instances 标注文件里类别 id 为 1 的就是 person可以直接用它生成 YOLO 格式的 txt。网上关于“yolov8目标检测数据集处理”的热度很高但大部分人卡在 COCO 的 JSON 嵌套结构上。我一般用pycocotools读标注边读边按图片尺寸换算坐标。合入公开数据后要注意一个坑COCO 里的人物尺度分布和门禁场景差异很大。COCO 图片里很多是半身像、多人聚会、运动场景直接混入会让模型对“完整人体”的响应权重过高训练出来后在门禁摄像头的俯视或广角画面里面容易漏检。解决办法是在合并时做一次尺度过滤只保留 box 高度占图片高度 30% 以上的目标这样留下的样本更接近“靠近门口、准备触发门禁”的姿态。目录结构上建议把所有图片放进datasets/images/txt 放进datasets/labels/再用一个train.txt和val.txt记录图片的相对路径YOLOv8 在data.yaml里可以按 txt 列表加载。2.4 data.yaml 的配置格式三个路径一个类表YOLOv8 训练时读取的数据配置是 YAML 文件和旧版 YOLOv5 的写法基本一致。内容如下# datasets/data.yaml path: ../datasets # 数据集根目录相对于你执行训练命令的位置 train: images/train # 训练图片目录可写相对 path 的路径 val: images/val # 验证图片目录 nc: 1 # 类别数量 names: [person] # 类别名顺序必须和 txt 里的 id 对应这里的train和val字段也可以直接指向包含图片路径的 txt 文件列表但前提是路径要写对。很多人习惯把path写成绝对路径我的经验是写成相对路径配合工作目录切换比较稳因为换了一台机器跑就少改一处。nc和names的顺序问题是翻车高发地记住一个原则txt 里写的是0 0.5 0.5 0.2 0.3就代表names[0]是 person一旦你在names里写成[face, person]整个训练就乱了而且训练过程不会报错损失函数会一直降但实际学的是错的东西。3. 训练一个能用于门禁的模型环境配置、参数含义和损失曲线判读数据集备好后训练环节是最容易消耗耐心的一步。这一章覆盖从环境准备到训练命令的完整流程再讲清楚几个必须手工调的训练参数分别控制什么行为。3.1 环境配置CPU 也能跑但要有预期管理从热搜词里能看到大量“ubuntu20.04搭建yolov8环境cpu版本”和“yolov8环境配置”的检索需求说明很多人第一台机器没有 NVIDIA 显卡。纯 CPU 跑 YOLOv8 训练是能跑的但速度确实感人。以 1000 张图、batch8、epochs100 为例一颗 i5 级别的 CPU 跑完可能要 10 小时以上。如果你不是必须在本机训练我一般建议先装 CPU 版把流程跑通、确认代码没问题再用 GPU 或云 GPU 做正式训练。环境安装的核心是ultralytics库和配套的 PyTorch。命令如下# 创建虚拟环境避免和系统 Python 打架 conda create -n yolo_door python3.9 -y conda activate yolo_door # 安装 CPU 版 PyTorch注意这个命令不装 CUDA 组件 pip install torch torchvision --index-url https://download.pytorch.org/whl/cpu # 安装 YOLOv8 本体 pip install ultralytics # 验证安装是否成功跑一次官方预训练权重推理 yolo predict modelyolov8n.pt sourcehttps://ultralytics.com/images/bus.jpg参数解释--index-url https://download.pytorch.org/whl/cpu是 CPU 版 PyTorch 的关键不加这个后缀的话默认会拉 CUDA 版即使你的机器没有显卡也能装但会白白占用几个 G 的磁盘空间。modelyolov8n.pt表示用 nano 版本权重做推理这一步不是训练只是验证环境完整性。跑通后你会看到一张 bus.jpg 的标注图说明检测链路已经通了。如果你有 NVIDIA 显卡则不需要加--index-url直接用pip install torch torchvision装默认版本即可但要在训练前用python -c import torch; print(torch.cuda.is_available())确认 CUDA 是否真的可用。这一步出现 False 的话后面所有训练都会静默地在 CPU 上跑跑了一个小时后才发现就晚了。3.2 训练命令与五个必调参数YOLOv8 的训练命令极简参数全通过命令行传入。门禁项目我常用的训练命令是yolo train \ modelyolov8n.pt \ datadatasets/data.yaml \ epochs100 \ batch8 \ imgsz640 \ patience10 \ device0 \ projectruns/door_train \ nameexp_person \ lr00.01各参数的实际影响按优先级排序说明imgsz640是输入分辨率。门禁摄像头一般画面广、人小我建议不要低于 640低于这个值会显著影响远端小目标的召回率。batch8对 CPU 或 8G 显存来说是安全值显存 6G 就降到 412G 以上可以上 16。patience10是早停策略表示验证集指标连续 10 轮不提升就提前结束训练这个参数对时间和实验次数的节省非常明显。device0指定第一块 GPUCPU 环境要改成devicecpu。project和name共同决定了权重文件的输出路径最终模型在runs/door_train/exp_person/weights/best.pt。训练过程里最需要关注的不是终端打印的每一轮损失值而是验证集上的mAP50和mAP50-95。mAP50 在门禁这种单类检测任务里做到 0.9 以上基本说明数据集质量没问题。如果 mAP50 卡在 0.6 到 0.7 上不去优先怀疑标注框太松或类别错标而不是盲目加 epochs。3.3 损失函数曲线怎么画、翻车曲线长什么样“yolov8画损失函数曲线图”是常见检索词其实训练结束后不用重新画runs/door_train/exp_person/目录下会生成results.csv里面已经按轮次记录了train/box_loss、val/box_loss、metrics/mAP50等全部数值。我习惯写一个 30 行的脚本读 CSV 画图因为答辩时需要展示原始的损失收敛过程。import pandas as pd import matplotlib.pyplot as plt results pd.read_csv(runs/door_train/exp_person/results.csv) # CSV 第一列是 epoch后续列名可能带空格统一清洗 results.columns results.columns.str.strip() fig, ax1 plt.subplots(figsize(10, 5)) ax1.plot(results[epoch], results[train/box_loss], labeltrain box loss, colortab:blue) ax1.plot(results[epoch], results[val/box_loss], labelval box loss, colortab:orange) ax1.set_xlabel(epoch) ax1.set_ylabel(box loss) ax1.legend(locupper right) ax2 ax1.twinx() ax2.plot(results[epoch], results[metrics/mAP50], labelmAP50, colortab:green, linestyle--) ax2.set_ylabel(mAP50) ax2.legend(loclower right) plt.title(YOLOv8 Door Access Training Curve) plt.tight_layout() plt.savefig(training_curve.png, dpi200)这个脚本没有复杂的逻辑核心是读 CSV 列名时要.str.strip()因为 ultralytics 输出的 CSV 列名里偶发带空格直接按列名取会 KeyError。画出来的曲线里如果train/box_loss降得很好但val/box_loss先降后升就是典型的过拟合此时的best.pt会出现在验证损失最低点附近但你应当关注它对应的 mAP50 是否足够高以及它在真实门禁视频里是否表现稳定。训练好的best.pt大约几 MB 到几十 MB取决于用的是yolov8n还是yolov8s。门禁项目我通常选yolov8n因为推理速度快、CPU 也能带动精度上的损失在近距离门前场景几乎感知不到。如果现场是 20 米长走廊需要远端检测才考虑上yolov8s。4. 把模型接进可视化界面摄像头推流、检测线程与开关门逻辑训练好的模型只是一堆权重文件它本身不会“开门”。可视化界面的作用是让检测结果变成可操作的控制信号同时让用户能直观看到画面、状态、记录。这一章讲的是从视频流输入到界面联动的完整链路。4.1 界面技术选型PyQt5 还是 Tkinter智能门禁系统仓库里通常带一个可视化界面毕设答辩时这一部分是演示重点。技术选型上Tkinter 是 Python 自带的不需要额外装库但要做出“看起来像产品”的界面会比较费力PyQt5 功能强、样式好但打包体积会大 100MB 左右。我的建议是如果只是答辩演示用 Tkinter 够用如果你想在界面上放视频控件、显示检测框、做通过记录列表PyQt5 的 QVideoWidget 和 QTableWidget 更顺手。下面以 PyQt5 为例。界面主窗口的骨架代码如下import sys import cv2 from PyQt5.QtWidgets import QApplication, QMainWindow, QLabel, QVBoxLayout, QWidget from PyQt5.QtCore import QTimer from PyQt5.QtGui import QImage, QPixmap from ultralytics import YOLO class DoorAccessApp(QMainWindow): def __init__(self): super().__init__() self.setWindowTitle(智能门禁系统 - YOLOv8) self.setGeometry(100, 100, 900, 600) # 加载训练好的权重这是整个界面能“看懂”画面的前提 self.model YOLO(runs/door_train/exp_person/weights/best.pt) # 摄像头来源0 表示本机摄像头也可以是 RTSP 地址 self.cap cv2.VideoCapture(0) self.cap.set(cv2.CAP_PROP_FRAME_WIDTH, 1280) self.cap.set(cv2.CAP_PROP_FRAME_HEIGHT, 720) # 每 30ms 刷新一帧约 33fps界面流畅度足够 self.timer QTimer() self.timer.timeout.connect(self.update_frame) self.timer.start(30) # 界面控件用一个 QLabel 显示画面 self.image_label QLabel() layout QVBoxLayout() layout.addWidget(self.image_label) container QWidget() container.setLayout(layout) self.setCentralWidget(container) def update_frame(self): ret, frame self.cap.read() if not ret: return # 转为 RGB 是因为 ultralytics 要求 RGB 输入 frame_rgb cv2.cvtColor(frame, cv2.COLOR_BGR2RGB) results self.model.predict(frame_rgb, conf0.5, imgsz640, verboseFalse) annotated results[0].plot() # 直接在原图画框 h, w, ch annotated.shape bytes_per_line ch * w qimg QImage(annotated.data, w, h, bytes_per_line, QImage.Format_RGB888) self.image_label.setPixmap(QPixmap.fromImage(qimg)) if __name__ __main__: app QApplication(sys.argv) window DoorAccessApp() window.show() sys.exit(app.exec_())这段代码的逻辑拆开看很清晰self.model YOLO(...)加载权重后后面的predict调用全部走同一套模型实例QTimer每 30ms 触发一次update_frame函数内做读帧、推理、画框、转 QImage 显示。有两个参数值得细说conf0.5是置信度阈值门禁场景里建议调到 0.6 以上因为误检一扇门突然打开比漏检一个人更吓人verboseFalse是为了避免终端每帧都刷检测日志否则跑 20 分钟日志文件就几个 G。运行这个界面类之前要确认摄像头索引对不对。笔记本自带摄像头一般是 0外接 USB 摄像头可能变成 1买回来的 USB 摄像头驱动后在 Windows 上多占一个索引。判定的办法是单独跑两行代码cap cv2.VideoCapture(0)然后cap.read()看返回的是不是 False。这一步是新手最容易卡住的“黑匣子”之一。4.2 门禁联动逻辑什么时候算“有效触发”只把画面和检测框显示出来界面再好看也不算“门禁系统”。门禁的判定逻辑一般放在update_frame里用一个回调函数处理检测结果。常见做法是当 person 类目标出现在画面某个 ROI感兴趣区域内并且连续 N 帧维持才认为“有人靠近门口”进而触发后续动作。# 在 DoorAccessApp 里增加以下成员变量和逻辑 self.trigger_count 0 self.trigger_threshold 5 # 连续 5 帧检测到人才触发开门 self.is_locked True def handle_detection(self, results): # 假设 ROI 是画面中央偏下的矩形区域 frame_h, frame_w 720, 1280 roi (int(frame_w*0.2), int(frame_h*0.4), int(frame_w*0.8), int(frame_h*0.9)) person_detected False for box in results[0].boxes: x1, y1, x2, y2 box.xyxy[0].tolist() # 计算目标中心点判断是否落在 ROI 内 cx (x1 x2) / 2 cy (y1 y2) / 2 if roi[0] cx roi[2] and roi[1] cy roi[3]: person_detected True break if person_detected: self.trigger_count 1 else: self.trigger_count 0 # 人走了计数清零防止累积误触发 if self.trigger_count self.trigger_threshold and self.is_locked: self.unlock_door() self.is_locked False帧计数防误触是门禁项目里必备的策略原理很好懂单帧误检是随机的不太可能连续 5 帧都在同一个 ROI 里出现假目标。roi的坐标要按你现场画面调摄像头装在门上方朝下拍时ROI 应该收缩到画面下半部分如果装在门的侧面ROI 可能要跟着透视角变化。unlock_door()是占位函数毕设里一般用串口发指令给 Arduino 控制继电器或者直接写个日志记录“开门时间”真实接锁需要按硬件协议改这个函数。4.3 串口控制与记录导出让系统成为一个能说清的闭环如果仓库的部署教程里包含下位机联动那unlock_door()里通常是 pyserial 发指令。这个部分要单独处理因为串口是有阻塞风险的放在 GUI 主线程里会让界面卡顿。常见做法是开一个后台线程专门写串口。import serial import threading class DoorController: def __init__(self, portCOM3, baudrate9600): try: self.ser serial.Serial(port, baudrate, timeout0.5) except Exception as e: print(f串口打开失败请检查设备: {e}) self.ser None def send_unlock(self): if self.ser is not None: # 假设继电器模块的开门指令是 ASCII 字符 1 self.ser.write(b1) print(发送开门信号)串口逻辑本身不复杂但要注意serial.Serial在初始化时如果设备被占用或端口不存在会抛异常所以必须用 try 包住。拿到self.ser后发送指令用write(b1)这里必须传 bytes不能传字符串。实际接硬件时指令协议以你的继电器模块说明书为准有的是高电平触发、有的是低电平触发还有的是发十六进制帧比如0xA0 0x01 0xA1一键开锁的信号协议改一个字节即可。在这个闭环里门禁系统的完整故事线是画面检测 → ROI 判定 → 帧计数 → 串口开锁 → 界面记录。这条线只要能说清楚答辩时评审问“系统怎么工作的”就可以一条线讲到底不会散。5. 避坑手册门禁项目最常见的五个翻车现场这类项目能跑通 demo 不难但要在答辩现场稳定演示需要提前排除下面五个高频故障。每条按“现象 → 原因 → 解决”来写都是我实际调试中遇到过或反复被问到的。5.1 训练正常但界面检测框全乱类别顺序错位现象模型训练时 loss 正常下降mAP 也高但拿到界面上运行检测框画在人的脸旁边而不是整个人身上或者画框正确但类别名显示错误。原因data.yaml里的names顺序和标注 txt 里的类别 id 不一致。比如标注时person是 0但names里写成了[face, person]模型训练时学到的类别语义就整体错位了。更隐蔽的是有些人复用别人训练好的权重文件自己的界面代码里按另一套类别名去取results[0].names导致显示错位。解决训练开始前打印一次data.yaml的解析结果确认names[0]就是标注最多的那个类。换权重文件时用YOLO(best.pt).names打印模型自带类别列表再和界面代码里的标签映射对齐。5.2 CPU 跑预测时界面画面一卡一卡推理耗时太长现象界面 FPS 只有个位数画面像幻灯片。原因CPU 跑imgsz640的 YOLOv8单帧推理耗时可能到 300ms 以上加上摄像头读帧和画框30ms 的 QTimer 根本跑不满。解决分两步走。一是在predict里把imgsz降到 320门禁近景下精度损失不大推理时间可能缩短一半以上二是把 QTimer 间隔从 30 改成 60 或 80让单帧处理时间不那么紧。如果还想更快把模型model.predict换成model(frame, streamTrue)使用流式推理模式处理的帧与帧之间会复用部分计算资源。这两个方向试完界面都会有可感知的流畅度提升。5.3 模型在实验室 PC 上能跑换到答辩机器上找不到 best.pt现象在家里训练好权重拷去答辩教室的电脑运行界面时提示文件不存在或路径错误。原因代码里写的是绝对路径比如C:/Users/xxx/runs/door_train/exp_person/weights/best.pt换到别的机器上盘符和用户名都变了。解决统一改成相对路径或环境变量。把best.pt复制到项目根目录下的weights/文件夹中代码里写成weights/best.pt。答辩前再确认一个更隐蔽的坑ultralytics 的模型加载如果传入了不存在的文件路径它有时不会报错而是自动下载一个官方预训练权重到时候界面能跑、检测的是 coco 类别门口的人会被识别成 person 但是类别颜色和你的预期不一样。校验方法是打印model.names如果输出的是 80 个类别而不是 1 个说明路径错了。5.4 摄像头打不开或灰屏视频索引和权限问题现象界面启动后画面全黑或 QLabel 里什么都没有终端也没有报错。原因最常见的是摄像头索引不对或应用没有摄像头权限。Windows 上默认 0 号摄像头被微信或系统相机占用时cv2.VideoCapture(0)会读取失败但不抛异常。解决在DoorAccessApp.__init__里加一段检查self.cap.isOpened()返回 False 时就弹窗提示并在代码里把索引改成1再试。Linux 下要注意/dev/video0的权限当前用户不在video组里会打开失败sudo usermod -aG video 用户名可以解决但可能需要重启系统生效。5.5 录制界面视频回放时黑屏或音画不同步现象用 OBS 或 Bandicam 录制的演示视频场上人脸画框正常但视频文件里画面是黑的。原因录制软件抓取的是显卡加速显示层而 PyQt5 的 QLabel 默认绘制路径不走硬件叠加在部分采集卡或远程桌面环境下会捕捉不到画面。解决不要在答辩现场录制界面窗口改用一个独立的保存函数在update_frame里把annotated帧直接写入 mp4。用 OpenCV 的 VideoWriter 就行分辨率设为 1280x720帧率设为 15 或 20避免因为实际推理帧率不到 25 导致写入失败。演示时窗口里放实时画面录制的文件用作备份回放两不耽误。6. 让门禁系统真正能扛事模型导出、板端部署和阈值校准训练完成、界面跑通只代表项目“完成度 50%”。剩下的一半在于验证模型在真实门禁环境下的鲁棒性以及把推理放到更小、更便宜的设备上。6.1 导出 ONNX 并加速推理给界面或板子让出 CPUYOLOv8 原生支持导出多种格式门禁系统里最常见的是导出 ONNX然后切换到 onnxruntime 推理。这样做的理由很简单PyTorch 的推理有额外开销同一颗 CPU 上 onnxruntime 通常能带来 30% 到 50% 的速度提升。导出命令是yolo export modelweights/best.pt formatonnx dynamicTrue imgsz640dynamicTrue打开动态输入尺寸这样界面里即使不从 640 分辨率推理也能用其他尺寸喂进去不会报维度错。导出完成后在推理代码里用onnxruntime.InferenceSession加载输入名可以通过session.get_inputs()[0].name获取。如果你打算在 RK3588 这种边缘板子上部署导出 ONNX 后还要用板子自带的 RKNN 工具链再转一次转换时如果遇到unsupported op报错优先检查 yolov8 版本和工具链版本的匹配度这是板端部署最常见的坑。6.2 阈值校准conf 不是拍脑袋定的而是看错检代价很多同学把conf0.5当成默认值不改这在实际门禁里会出问题。门禁场景的错检代价不是对称的漏检的代价是“该开门的时候没开”最多让人等几秒误检的代价是“没人时门开了”这在安防场景里是致命问题。所以阈值应当往高了调。我实际项目的做法是把测试视频跑一遍统计不同阈值下的误报率挑出“误报为零但召回足够”的阈值。你可以把一段 10 分钟的门口视频跑两三遍分别用conf0.4、0.5、0.6、0.7看输出日志记下每档出现几次空检测框。如果 0.6 已经能压住误报就不要再提高到 0.8因为阈值的提高和召回是强相关的太高的阈值会在逆光场景把真实的人漏掉。通过这几层验证逻辑你对“基于YOLOv8的智能门禁系统”这个方向的理解就能从“跑通一个 demo”升级成“知道什么参数在什么场景下怎么动”。我个人的习惯是每次做这类项目都把训练参数、阈值和调试过程记在一个实验本上答辩或复盘时拿出来每一条都能讲出当时为什么翻车、怎么修的。这条经验帮我避了不少次“换一台机器就废”的尴尬希望也能帮到你。本文还有配套的精品资源点击获取