计算机视觉 / 系统课时
正确释放视频资源
正确释放视频资源
视频处理不仅要“跑完”,还要保证摄像头、视频文件、写入器和窗口在正常结束或异常中都能关闭。最稳妥的做法是把资源创建与处理放进 try,把释放动作统一放进 finally,这样即使读取、写入或显示阶段抛出异常,也不会长期占用设备或文件句柄。
学习目标
- 区分
VideoCapture、VideoWriter与窗口各自的释放方式。 - 使用
try...finally保证异常路径也执行清理。 - 识别忘记释放资源后常见的占用、文件不完整和窗口残留问题。
资源为什么必须显式清理
VideoCapture.release() 会关闭摄像头或视频文件句柄,VideoWriter.release() 会结束写入并让容器完成必要的尾部信息,cv2.destroyAllWindows() 用于销毁 OpenCV 创建的 GUI 窗口。仅仅让函数返回,不能作为稳定的资源管理策略,因为对象何时被垃圾回收并不适合作为业务约束。
一段视频处理通常同时持有多个资源,异常又可能发生在任意阶段。把释放动作集中到一个兜底路径,比在每个 if 或 except 分支里重复写清理代码更不容易遗漏。

用 finally 统一释放
下面的示例读取视频、写出副本并显示预览窗口。把 <PATH> 替换为实际路径后运行;在桌面环境按 q 可以提前退出。即使循环内部抛出异常,finally 仍会执行释放逻辑。
import cv2
video_path = "<PATH>/input.mp4"
output_path = "<PATH>/copy.mp4"
cap = None
writer = None
try:
cap = cv2.VideoCapture(video_path)
if not cap.isOpened():
raise RuntimeError(f"无法打开视频: {video_path}")
fps = cap.get(cv2.CAP_PROP_FPS)
width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))
if fps <= 0 or width <= 0 or height <= 0:
raise RuntimeError("无法读取有效的视频参数")
fourcc = cv2.VideoWriter_fourcc(*"mp4v")
writer = cv2.VideoWriter(output_path, fourcc, fps, (width, height))
if not writer.isOpened():
raise RuntimeError(f"无法创建输出视频: {output_path}")
while True:
ok, frame = cap.read()
if not ok:
break
writer.write(frame)
cv2.imshow("preview", frame)
if cv2.waitKey(1) & 0xFF == ord("q"):
break
print("处理结束")
finally:
if writer is not None:
writer.release()
if cap is not None:
cap.release()
cv2.destroyAllWindows()
print("资源已释放")预期输出
处理结束
资源已释放实际视频长度和窗口停留时间会不同。若处理阶段发生异常,处理结束 可能不会出现,但 finally 中的 资源已释放 仍会在异常继续向外传播前执行。
常见释放错误
最常见的问题是只释放读取器,却忘记释放写入器。此时输出文件可能已经有数据,但容器元信息尚未完整写入,表现为播放器无法打开、时长异常或文件末尾损坏。另一个常见问题是在多个提前 return 分支里手写释放,新增分支后很容易漏掉某个资源。
窗口资源也应在结束时统一销毁。若程序运行在无图形界面的服务器环境,应直接省略 imshow()、waitKey() 和窗口销毁相关逻辑,避免把 GUI 能力当作视频读写的必要条件。
验证清理是否生效
摄像头场景可以在程序退出后立即重新创建 VideoCapture 验证设备是否可再次打开;文件写入场景则检查输出视频能否被重新读取,并确认帧尺寸和时长合理。资源释放不是附加步骤,而是视频处理流程的一部分:只要代码存在正常退出、提前退出或异常路径,就应该让这些路径最终汇入同一个清理逻辑。