最近在学习OpenCV的物体跟踪模块，写了一个小项目练手：打开摄像头，按
s键用鼠标框选一个物体，程序就会自动跟随它的移动。代码虽然简单，但涵盖了物体跟踪的核心流程，还处理了OpenCV不同版本的兼容性、跟踪重置、丢失提示等细节。本文作为学习笔记，分享完整代码和关键知识点。
一、物体跟踪是什么？
物体跟踪（Object Tracking）是指在视频序列中，持续定位一个预先选定的目标。它与物体检测的区别在于：
-
检测：每一帧都独立找出所有物体，计算量大，但能处理任意目标。
-
跟踪 ：只在第一帧指定目标，后续帧利用时间连续性快速预测位置，实时性高。
OpenCV提供了多种跟踪算法，如KCF、CSRT、MOSSE等。本文使用KCF（Kernelized Correlation Filters），它在速度和精度之间取得较好平衡，适合实时应用。
二、环境准备
-
Python 3.x
-
OpenCV库（含
contrib模块）
安装命令：
pip install opencv-python opencv-contrib-python注意：从OpenCV 4.5.1开始，部分跟踪器被移入
cv2.legacy子模块。本文代码已做兼容处理。
三、完整代码
以下代码实现了：
-
打开默认摄像头
-
按
s键框选目标并开始跟踪 -
按
r键重置跟踪（可重新选目标） -
跟踪失败时显示"TRACKING LOST"提示
-
按
ESC键退出import cv2
----- 兼容不同OpenCV版本的跟踪器创建 -----
try:
# 适用于 OpenCV < 4.5.1
tracker = cv2.TrackerKCF_create()
except AttributeError:
# 适用于 OpenCV >= 4.5.1
tracker = cv2.legacy.TrackerKCF_create()tracking = False # 是否处于跟踪状态
cap = cv2.VideoCapture(0) # 0 为默认摄像头检查摄像头是否打开成功
if not cap.isOpened():
print("错误：无法打开摄像头")
exit()while True:
ret, frame = cap.read()
if not ret:
print("无法读取帧")
breakkey = cv2.waitKey(1) # ----- 按 s 键：选择目标并开始/重置跟踪 ----- if key == ord('s'): tracking = False # 先重置状态 roi = cv2.selectROI("Tracking", frame, False) # 如果用户取消了选择（roi为(0,0,0,0)），则不进行初始化 if roi != (0, 0, 0, 0): # 重新创建跟踪器，清除旧状态 try: tracker = cv2.TrackerKCF_create() except AttributeError: tracker = cv2.legacy.TrackerKCF_create() tracker.init(frame, roi) tracking = True # ----- 按 r 键：重置跟踪（不选新目标，只是停止） ----- elif key == ord('r'): tracking = False print("跟踪已重置，请按 s 选择新目标") # ----- 如果处于跟踪状态，更新跟踪器并绘制结果 ----- if tracking: success, box = tracker.update(frame) if success: x, y, w, h = [int(v) for v in box] cv2.rectangle(frame, (x, y), (x+w, y+h), (0, 255, 0), 2) else: # 跟踪失败时显示文字提示 cv2.putText(frame, "TRACKING LOST", (50, 50), cv2.FONT_HERSHEY_SIMPLEX, 1, (0, 0, 255), 2) cv2.imshow("Tracking", frame) # 按 ESC 退出 if key == 27: breakcap.release()
cv2.destroyAllWindows()
四、代码详解
1. 创建跟踪器（兼容性写法）
try:
tracker = cv2.TrackerKCF_create()
except AttributeError:
tracker = cv2.legacy.TrackerKCF_create()-
旧版OpenCV中
TrackerKCF_create直接在cv2下；新版移到了cv2.legacy。 -
用
try-except捕获AttributeError，自动选择正确的创建方式，避免因版本差异而报错。
2. 选择目标：cv2.selectROI()
roi = cv2.selectROI("Tracking", frame, False)-
弹出一个窗口，用户用鼠标框选感兴趣区域（ROI）。
-
返回值
roi = (x, y, w, h)是矩形框的位置和大小。 -
第三个参数
False表示从左上角拖到右下角画矩形（True表示从中心点画）。
3. 初始化跟踪器：tracker.init(frame, roi)
-
用选定的第一帧图像和ROI初始化跟踪器内部模型。
-
必须 在调用
update()之前调用，且只在目标选定或重新选择时调用一次。
4. 更新跟踪：tracker.update(frame)
-
对每一帧调用，返回
(success, box)。 -
success为True表示跟踪成功，box是新的目标矩形；否则为False。
5. 交互控制
-
s键：重置tracking标志，弹出选择框，重新初始化跟踪器。 -
r键：仅重置tracking标志，不选新目标（方便停止跟踪）。 -
ESC键：退出循环。
6. 跟踪失败提示
当success == False时，用cv2.putText()在画面左上角显示红色"TRACKING LOST"，让用户知道已跟丢。
五、运行方法
-
将上述代码保存为
object_tracking.py。 -
在终端运行：
python object_tracking.py -
摄像头打开后：
-
按下键盘
s键，画面会冻结并出现"Tracking"窗口。 -
用鼠标拖拽框选要跟踪的物体（例如你的手、一本书等）。
-
按回车 或空格确认选择。
-
程序开始自动跟踪，绿色框会跟随物体移动。
-
如果跟丢，画面显示"TRACKING LOST"，可按
r重置，再按s重新选择。 -
按
ESC退出程序。
-
六、效果展示
-
跟踪成功时，绿色矩形框会紧贴目标移动（即使目标在画面中旋转、稍微变形，KCF仍有一定鲁棒性）。
-
如果目标快速移动或被遮挡，跟踪可能会失败（出现红色文字），此时需要重新选择目标。
提示：为了获得更好的跟踪效果，可以尝试将
KCF换成CSRT（更准但稍慢）：python
tracker = cv2.legacy.TrackerCSRT_create()
七、常见问题
Q1：运行时报错 AttributeError: module 'cv2' has no attribute 'TrackerKCF_create'
A：说明你的OpenCV版本较新（≥4.5.1）。代码中的try-except已经处理了这种情况，请确保你完整复制了兼容性写法。如果仍然报错，请检查是否安装了opencv-contrib-python。
Q2：为什么跟踪一段时间后框会飘走？
A：KCF对遮挡、尺度变化、快速运动比较敏感。可以尝试换用CSRT算法，或者重新按s框选目标。
Q3：如何跟踪视频文件而不是摄像头？
A：将cv2.VideoCapture(0)改为视频路径，例如cv2.VideoCapture("test.mp4")。
Q4：selectROI弹出的窗口怎么关闭？
A：确认选择后按Enter或空格，窗口会自动关闭。如果不想选择，按ESC取消。
八、总结
通过这个小项目，你可以掌握：
-
OpenCV物体跟踪的基本流程：创建跟踪器 → 选择ROI → 初始化 → 逐帧更新。
-
处理不同OpenCV版本的兼容性问题。
-
增加交互逻辑（重置、失败提示）提升用户体验。
物体跟踪是计算机视觉中非常实用的技术，可以应用于自动驾驶、安防监控、人机交互等领域。希望这篇笔记能帮助你快速上手，自己动手试一试吧！
下一步学习建议：
-
尝试使用
CSRT或MOSSE算法，比较精度和速度。 -
学习多目标跟踪（MOT），同时跟踪多个物体。
-
结合YOLO等目标检测器，实现自动检测+跟踪。
完整代码已托管在我的Gitee仓库（链接略），欢迎交流讨论。
参考资料：
-
OpenCV官方文档：
cv::Tracker类 -
LearnOpenCV博客：Object Tracking using OpenCV
（本文为个人学习笔记，如有错误欢迎指正。）