使用OpenCV Python生成图片视频遇错误，求排查修正

嘿，我来帮你排查这个问题～你遇到的「Could not demultiplex stream」错误大多是因为视频文件写入环节出了问题，结合你的场景，大概率是这几个细节没做好：

1. 没过滤非图片文件，且图片顺序混乱 #

os.listdir()会返回当前目录下所有文件（包括文件夹、非图片格式文件），而且默认排序不是按数字逻辑来的（比如1.jpg会排在10.jpg后面），这会导致读取到无效文件或图片顺序错乱，最终损坏视频文件。

解决办法：

• 只筛选.jpg/.png等图片格式的文件
• 对图片文件名做自然排序，保证播放顺序正确

2. VideoWriter编码格式不兼容 #

不同操作系统支持的视频编码不一样，如果编码选错，写入的视频会损坏，导致无法解码播放：

• Windows：推荐用DIVX
• Linux：推荐用XVID或MJPG
• Mac：推荐用avc1（需OpenCV支持）

解决办法：优先用兼容性强的MJPG编码，或者根据系统选择对应编码。

3. 调整尺寸后的数据格式/通道数不一致 #

有些图片是灰度图（单通道），有些是彩色图（3通道），如果通道数不统一，写入视频时会出错；另外要确保调整后的图片是uint8类型（OpenCV要求的格式）。

解决办法：统一将所有图片转为3通道彩色图，强制数据类型为uint8。

4. 未正确释放VideoWriter资源 #

写完视频后如果没调用release()关闭资源，视频文件会处于未完成状态，导致无法正常播放。

解决办法：写入完成后必须调用out.release()，还要销毁所有OpenCV窗口。

import cv2
import numpy as np
import os
from natsort import natsorted  # 用于自然排序，需先安装：pip install natsort

# 配置参数
output_video_name = "output.mp4"
frame_rate = 30  # 视频帧率，可按需修改
target_size = (1280, 720)  # 统一的图片目标尺寸，可按需修改

# 筛选当前目录下的图片文件
image_extensions = ['.jpg', '.jpeg', '.png', '.bmp']
image_list = [f for f in os.listdir(os.getcwd()) if os.path.splitext(f)[1].lower() in image_extensions]

# 对图片做自然排序，保证播放顺序正确
image_list = natsorted(image_list)

if not image_list:
    print("未找到任何图片文件！")
    exit()

# 初始化VideoWriter，用兼容性强的MJPG编码
fourcc = cv2.VideoWriter_fourcc(*'MJPG')
out = cv2.VideoWriter(output_video_name, fourcc, frame_rate, target_size)

for filename in image_list:
    # 读取图片
    img_path = os.path.join(os.getcwd(), filename)
    img = cv2.imread(img_path)
    
    # 跳过无法读取的图片
    if img is None:
        print(f"警告：无法读取图片 {filename}，已跳过")
        continue
    
    # 灰度图转彩色图，统一通道数
    if len(img.shape) == 2:
        img = cv2.cvtColor(img, cv2.COLOR_GRAY2BGR)
    # 调整图片尺寸
    resized_img = cv2.resize(img, target_size)
    # 确保数据类型符合要求
    resized_img = resized_img.astype(np.uint8)
    
    # 写入视频帧
    out.write(resized_img)

# 释放所有资源
out.release()
cv2.destroyAllWindows()
print(f"视频已成功生成：{output_video_name}")

• 如果不想安装natsort，可以手动实现数字排序（仅适用于文件名是纯数字的情况）：

  image_list.sort(key=lambda x: int(os.path.splitext(x)[0]))
  

  若文件名带前缀（比如img_1.jpg），可以修改lambda表达式提取数字部分。
• 如果视频还是无法播放，尝试更换编码格式，比如把MJPG换成DIVX（Windows）或XVID（Linux）。
• 务必保证所有图片调整后的尺寸和target_size完全一致，不能有偏差。

内容的提问来源于stack exchange，提问作者dip deb