本文详解如何使用 OpenCV 和 Python 正确遍历并逐个播放文件夹（含子目录）中所有 .mp4 文件，修复常见循环结构错误、资源释放问题及 OpenCV 播放逻辑缺陷。
本文详解如何使用 opencv 和 python 正确遍历并逐个播放文件夹（含子目录）中所有 `.mp4` 文件，修复常见循环结构错误、资源释放问题及 opencv 播放逻辑缺陷。
要实现“自动读取并顺序播放文件夹内所有 MP4 文件（1.mp4 → 2.mp4 → …）”，关键在于：每个视频必须独立完成打开、逐帧解码、显示、释放的完整生命周期，且逻辑需严格嵌套在文件遍历循环内。原代码中 cv2.VideoCapture(tt) 及后续播放逻辑被错误地写在 for file in files 循环外部，导致仅处理最后一个文件；同时存在资源未正确释放、条件判断冗余、等待时间不合理等问题。
以下是修正后的完整可运行代码：
import os
import cv2
folder_path = r'f:\a' # 注意：Windows 路径建议使用原始字符串（r''）或双反斜杠
for root, dirs, files in os.walk(folder_path):
for file in files:
if file.lower().endswith('.mp4'): # 仅处理 .mp4 文件（忽略大小写）
video_path = os.path.join(root, file)
print(f"正在播放: {video_path}")
cap = cv2.VideoCapture(video_path)
if not cap.isOpened():
print(f"⚠️ 无法打开视频: {video_path}")
continue
while cap.isOpened():
ret, frame = cap.read()
if not ret: # 视频结束或读取失败
break
cv2.imshow('MP4 Player', frame)
# 每帧显示约 33ms（约30fps），按 'q' 键提前退出当前视频
if cv2.waitKey(33) & 0xFF == ord('q'):
break
# ✅ 关键：每段视频播放结束后立即释放资源
cap.release()
cv2.destroyAllWindows() # 清除当前窗口，避免多窗口残留
print("✅ 所有 MP4 文件播放完毕。")
✅ 核心改进说明：
-
正确作用域：
cv2.VideoCapture()、播放循环、cap.release()和cv2.destroyAllWindows()全部置于for file in files内部，确保每个文件独立处理； -
安全过滤：通过
file.lower().endswith('.mp4')排除非 MP4 文件，提升健壮性； -
错误处理：检查
cap.isOpened()防止因损坏文件导致程序崩溃； -
合理延时：
cv2.waitKey(33)实现近似 30 FPS 的流畅播放（而非waitKey(1)导致过快闪退）； -
资源清理：每次播放后调用
cap.release()和cv2.destroyAllWindows()，避免内存泄漏与窗口堆积。
⚠️ 注意事项：
- 若需严格按数字顺序播放（如
1.mp4,2.mp4, …），应先对files列表排序：files = sorted([f for f in files if f.lower().endswith('.mp4')], key=lambda x: int(os.path.splitext(x)[0]) if x.split('.')[0].isdigit() else 0)
（更鲁棒方案建议使用natsort库进行自然排序）； -
cv2.imshow()窗口依赖 GUI 环境，在无界面服务器（如 Linux headless）需配置 OpenCV 的cv2.setNumThreads(0)并使用cv2.namedWindow(..., cv2.WINDOW_NORMAL)等适配； - 大量高清视频连续播放时，建议添加异常捕获（
try/except）和日志记录，便于调试。
掌握循环嵌套逻辑与资源生命周期管理，是编写可靠多媒体处理脚本的基础。务必避免将依赖单次迭代变量的代码移出循环体——这是初学者最常见的结构性错误之一。
