本文详解YOLOv8推理结果的正确提取方式，针对视频流中汽车轮廓无法绘制的问题，提供标准、鲁棒的Results对象遍历方法，并给出完整可运行代码及关键避坑提示。
本文详解yolov8推理结果的正确提取方式，针对视频流中汽车轮廓无法绘制的问题，提供标准、鲁棒的`results`对象遍历方法，并给出完整可运行代码及关键避坑提示。
YOLOv8 的 model(frame) 返回的是一个 Results 对象（非原始 NumPy 数组或列表），它是一个结构化容器，封装了检测框（.boxes）、掩码（.masks）、关键点（.keypoints）等多模态输出。初学者常误将其当作普通张量列表处理（如 results[0] 或 detection[-1]），导致索引越界、属性访问失败或静默跳过——这正是你视频中“无矩形显示”的根本原因：car_results = [detection for detection in results if detection[-1] in [2,5,7]] 这一行逻辑完全错误，因为 results 是单元素列表（长度恒为1），且其元素 result 并不支持下标取值 [-1]；而 result.xyxy[0] 也仅在 result.boxes.xyxy 非空时才有效，直接解包会引发 IndexError。
✅ 正确做法是逐层访问 Results → Boxes → tensor → item()，遵循 Ultralytics 官方推荐的数据流：
import cv2
from ultralytics import YOLO
model = YOLO('yolov8s.pt') # 推荐使用 .pt 格式权重，确保兼容性
video_path = 'output2.avi'
cap = cv2.VideoCapture(video_path)
if not cap.isOpened():
print("❌ 错误：无法打开视频文件，请检查路径或格式")
exit()
# COCO 类别索引参考（关键！）
# 2: car, 5: bus, 7: truck —— 你原代码中的 [2,5,7] 是正确的类别ID
TARGET_CLASSES = {2, 5, 7}
while cap.isOpened():
ret, frame = cap.read()
if not ret:
break
# ✅ 正确推理 & 结果解析
results = model(frame) # 返回 Results 列表，通常 len=1
# 遍历每个 Results 对象（单帧即一个）
for result in results:
# 遍历该帧中所有检测框
for box in result.boxes:
cls_id = int(box.cls.item()) # 获取整数类别ID
conf = float(box.conf.item()) # 置信度（建议添加阈值过滤）
if cls_id in TARGET_CLASSES and conf > 0.5: # 建议增加置信度过滤
# 提取归一化坐标并转为整数像素坐标
x1, y1, x2, y2 = map(int, box.xyxy[0].tolist())
# 绘制红色矩形（BGR格式）
cv2.rectangle(frame, (x1, y1), (x2, y2), (0, 0, 255), 2)
# 可选：添加标签文本
label = f"{model.names[cls_id]} {conf:.2f}"
cv2.putText(frame, label, (x1, y1 - 10),
cv2.FONT_HERSHEY_SIMPLEX, 0.6, (0, 0, 255), 2)
cv2.imshow('YOLOv8 Car Detection', frame)
if cv2.waitKey(1) & 0xFF == ord('q'):
break
cap.release()
cv2.destroyAllWindows()
? 关键注意事项与进阶提示：
- 类别ID务必核对：YOLOv8 默认使用 COCO 80 类索引（car=2, truck=7, bus=5），若你使用自定义数据集，请用 model.names 打印确认：print(model.names)；
- 务必添加置信度过滤：box.conf.item() 返回浮点值，低置信度框易引入噪声，建议 conf > 0.5 起步；
- 避免 .cpu().numpy() 过度调用：box.xyxy[0].tolist() 已足够高效，无需显式 .cpu().numpy()（除非后续需复杂数组运算）；
- 性能优化建议：对实时视频流，可启用 stream=True 模式减少内存拷贝：results = model(frame, stream=True)；
- 车道计数扩展逻辑：要在帧中线（如 y_mid = frame.shape[0] // 2）统计穿越车辆，需记录每辆车 y1/y2 与中线关系，并设计状态机防重复计数（例如：仅当车辆中心 cy = (y1+y2)//2 由上向下穿越中线时 +1）。
掌握 Results 对象的树状结构（results → .boxes → .xyxy/.cls/.conf）是 YOLOv8 工程落地的第一道门槛。跳过此步强行“暴力解包”，90% 的可视化失败与统计异常都源于此。坚持按官方文档范式操作，即可稳定提取坐标、置信度与类别，为后续计数、裁剪、跟踪等工业级任务打下坚实基础。
