cv::TrackerKCF::create() 返回空指针是因为OpenCV 4.x默认未启用tracking模块，需手动编译opencv_contrib并开启-BUILD_opencv_tracking=ON，且链接opencv_tracking库；init()失败主因是ROI宽高非正、首帧图像格式错误或ROI越界。
cv::TrackerKCF::create() 为什么返回空指针？
OpenCV C++ 的目标跟踪接口在 4.x 版本中默认不启用 tracking 模块，cv::TrackerKCF::create() 返回 nullptr 是最常见现象。这不是代码写错了，而是库没编译进 tracking 模块。
验证方式：运行 cv::getBuildInformation()，搜索 tracking，若显示 NO 或未出现，说明缺失。
- Linux/macOS 下需在 CMake 配置时加
-DBUILD_opencv_tracking=ON，并确保contrib模块已正确关联（路径用-DOPENCV_EXTRA_MODULES_PATH指向 opencv_contrib/modules） - Windows 用户若用预编译包，基本都不含 tracking；必须自己用 VS + CMake 重新编译完整版
- 即使编译成功，也要确认链接了
opencv_tracking库（CMakeLists.txt 中加target_link_libraries(your_app opencv_tracking)）
cv::Tracker::init() 失败的三个典型原因
init() 返回 false，通常不是算法问题，而是输入不满足底层约束。
-
boundingBox坐标必须是cv::Rect格式（x, y, width, height），且width > 0 && height > 0；用cv::Rect2d或负宽高会静默失败 - 首帧图像不能为
cv::Mat::empty()，也不能是单通道以外的格式（如 BGRA、RGBA）——KCF 和 MOSSE 要求CV_8UC3或CV_8UC1，传入CV_32F会崩溃 - ROI 不能超出图像边界：检查
rect.x + rect.width 和 <code>rect.y + rect.height ，越界会导致 init 直接返回 false
cv::TrackerMOSSE vs cv::TrackerKCF：选哪个？
MOSSE 启动快、CPU 友好，KCF 精度略高但更吃资源，二者都不支持重检测（re-detection）——目标完全丢失后不会自动找回。
-
cv::TrackerMOSSE::create()初始化耗时约 0.5–2ms，适合嵌入式或 60fps 场景；但对尺度突变、快速旋转鲁棒性差 -
cv::TrackerKCF::create()初始化 5–15ms，支持 HOG 特征（构造时传cv::TrackerKCF::Params{true}），精度提升明显，但内存占用翻倍 - 二者都只接受单目标：若想跟踪多个目标，必须对每个 ROI 单独创建 tracker 实例，不能复用同一个对象
跟踪结果 bbox 坐标偏移或抖动怎么办？
原始 tracker 输出的 cv::Rect 是浮点精度内部计算后截断的结果，直接渲染常出现跳变。不要跳过后处理。
- 加简单卡尔曼滤波：用
cv::KalmanFilter对 bbox 的中心点 (x,y) 和宽高 (w,h) 做 4D 状态估计，比纯平滑更稳 - 手动限速：记录上一帧 bbox，新结果与之的中心偏移超过
0.3 * last_w或宽高变化超 ±20%，就丢弃本次输出，沿用上一帧 - 避免在 init 后立刻读取结果：至少调用一次
update()再取值；首次update()的输出可能仍不稳定
真正难的是目标被遮挡后的恢复——OpenCV 自带 tracker 全部无此能力，得自己加检测器（如 YOLOv5 推理）定期触发 re-init，这部分逻辑不在 tracker 接口里，容易被忽略。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
