使用OpenCV每1秒保存一帧遇问题：图片无法保存至系统

你的代码存在几个关键问题导致图片无法保存，具体分析和修复方案如下：

核心问题点 #

• 路径拼接错误：output_file定义时开头带了斜杠/，和/TestFrames/拼接后会形成/TestFrames//Frame_...的异常路径；同时根目录下的TestFrames文件夹大概率不存在，且普通用户通常没有根目录的写入权限。
• 文件名含非法字符：%H:%M:%S格式生成的文件名包含冒号:，Windows系统完全禁止文件名使用该字符，Linux/macOS也不推荐，直接导致保存失败。
• 未验证保存结果：cv2.imwrite会返回布尔值表示保存是否成功，代码未做判断，无法确认保存操作的执行状态。

修正后的代码 #

import cv2
import time
import os

# 打开默认摄像头
cap = cv2.VideoCapture(0)

# 设置帧宽高
cap.set(cv2.CAP_PROP_FRAME_WIDTH, 640)
cap.set(cv2.CAP_PROP_FRAME_HEIGHT, 480)

# 创建保存目录（不存在则自动生成）
save_dir = "./TestFrames"
if not os.path.exists(save_dir):
    os.makedirs(save_dir)

start_time = time.time()
print("looping through frames")

while True:
    ret, frame = cap.read()
    t = time.localtime()
    # 把时间格式的冒号替换为下划线，避免非法字符
    current_time = time.strftime("%H_%M_%S", t)
    
    # 生成文件名并拼接完整路径
    output_file = f'Frame_{current_time}.jpg'
    full_path = os.path.join(save_dir, output_file)

    if not ret:
        print("无法捕获帧")
        break

    elapsed_time = time.time() - start_time
    if elapsed_time >= 1:
        print("1 second passed")
        # 保存图片并检查结果
        success = cv2.imwrite(full_path, frame)
        if success:
            print(f"图片已保存至: {full_path}")
        else:
            print(f"保存图片失败: {full_path}")
        
        start_time = time.time()
        print("time reset")

    cv2.imshow('frame', frame)
    if cv2.waitKey(1) == ord('q'):
        break

cap.release()
cv2.destroyAllWindows()

关键修改说明 #

• 用os.path.join自动拼接路径，避免手动处理斜杠的错误，同时提前创建保存目录，确保目录存在。
• 将时间格式中的冒号替换为下划线，解决文件名非法字符问题。
• 检查cv2.imwrite的返回值，明确保存结果，方便排查问题。
• 使用相对路径./TestFrames，文件会保存在代码运行的当前目录下，避免根目录权限问题。

内容的提问来源于stack exchange，提问作者Darsh. S.