YOLO v8.3.252 发布！TQDM双“100%”Bug终结、导出更稳定、日志更干净、文档更智能的全方位升级|发布|控制台|示例|追踪

2026年1月10日，Ultralytics团队正式发布了YOLO v8.3.252版本。这次更新虽然不是一次大版本迭代，但绝对是一次极具实用性的 “打磨式” 更新。整体聚焦在控制台输出优化、导出稳定性增强、平台链接清理，以及文档参数全面校准，从细节处让开发、训练和验证体验更加顺畅。

更新概要

YOLO v8.3.252 专注解决 Ultralytics 控制台输出的细节问题，最突出改进是修复了 tqdm 进度条在完成时出现重复 “100% 完成” 的情况，让训练和验证日志更加干净整洁。

关键变化一览进度条优化 —修复重复 100% 状态

• 在ultralytics/utils/tqdm.py中新增保护机制：避免在进度条已打印 100% 时再次重绘。
• 实现逻辑：如果末次渲染时self.n == self.last_print_n，则跳过重复显示。
• 效果：训练日志不再出现双行 “100% complete”，自动化流水线的日志更清晰。

导出稳定性提升 —缓存形状重置

• 位置：ultralytics/engine/exporter.py
• 更新：在模型导出时加入m.shape = None操作，重置缓存输入形状。
• 目的：避免重复导出时使用旧的缓存形状，在更换imgsz时保证输出一致性。

Ultralytics HUB / 平台链接更干净 —slugify 机制新增

• 文件：ultralytics/utils/callbacks/platform.py
• 新增函数：slugify()和_get_project_name()
• 功能：对 project 和 run 名称进行 URL 安全化转换，防止特殊字符破坏链接。
• 改进：
- • 项目名与运行名均通过slugify生成短链；
- • 平台日志显示链接更可读、不再出现乱码或断链。

文档与示例参数全面同步调整 Tracking 模式调整（更合理默认值）

• 示例更新：
.

results = model.track(source="https://youtu.be/LNwODJXcvt4", conf=0.1, iou=0.7, show=True)

• CLI 对应更新：
.

yolo track model=yolo11n.pt source="https://youtu.be/LNwODJXcvt4" conf=0.1 iou=0.7 show=True

• 默认追踪行为更接近实际使用场景，conf 由 0.3 调低至 0.1，iou 提高至 0.7，追踪更稳定。

Predict 模式示例更新（更实用置信度）

• 更改：conf默认值从 0.5 调整至 0.25。
• 提高模型在预测时的召回率，减少 “检测不到目标” 的困惑。

✅ Val 模式对齐标准

• 文档统一iou=0.7，与追踪、预测模式一致。

• CLI 从旧参数：
.

yolo val model=yolo11n.pt data=coco8.yaml imgsz=640 batch=16 conf=0.25 iou=0.6 device=0

更新为： .

yolo val model=yolo11n.pt data=coco8.yaml imgsz=640 batch=16 conf=0.25 iou=0.7 device=0

• 目的：验证阶段评估更严谨，与训练检测标准一致。

导出文档优化

• INT8 校准数据说明：
- • 当未提供数据集配置时，自动使用coco8.yaml作为备用。
- • 描述更加明确：'coco8.yaml' will be used as a fallback for calibration。

Anchor 生成优化，减少警告

• 文件：ultralytics/utils/tal.py
• 改动：遍历逻辑从for i, stride in enumerate(strides):改为for i in range(len(feats)):
• 效果：解决 Tracing 期间的TracerWarning，提升模型导出稳定性。

文档宏参数同步更新

• 训练、验证和追踪文档参数全面校正：
- •plots默认调整为True（生成可视化结果）。
- •verbose默认值修改为True（日志更详细）。
- •FP16 half默认值统一为False（在验证中更稳定）。
- •track-args.md内追踪参数调整为更平衡组合（conf=0.1，iou=0.7）。
- •train-args.md内的kobj权重从 2.0 调整为更合理的 1.0。