OpenCV/CV2视频生成：FPS与帧不同步问题求助

问题根源 #

你的问题核心是：原视频可能并非严格的固定30FPS，而是存在微小帧率波动，或是采用可变帧率（VFR）格式。OpenCV按固定30FPS写入时，会忽略原视频的实际帧时间戳，导致输出时长累计偏差，长视频的误差会被大幅放大。

具体解决步骤 #

1. 复用原视频的精确帧率与帧数匹配 #

不要硬写out_fps=30，直接读取原视频的实际帧率，同时严格控制输出帧数与原视频一致：

cap: cv2.VideoCapture = cv2.VideoCapture("example_video.mkv")
# 获取原视频精确帧率
original_fps = cap.get(cv2.CAP_PROP_FPS)
# 获取原视频总帧数
total_frames = int(cap.get(cv2.CAP_PROP_FRAME_COUNT))

frame_width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
frame_height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))
fourcc = cv2.VideoWriter_fourcc(*'mp4v')
out = cv2.VideoWriter('output.mp4', fourcc, original_fps, (frame_width, frame_height))

processed_frames = 0
while cap.isOpened():
    success: bool
    frame: cv2.typing.MatLike
    success, frame = cap.read()
    if success and processed_frames < total_frames:
        # 分析并修改帧
        # * analyzing and modifying frame *
        out.write(frame)
        processed_frames += 1
    else:
        break

out.release()
cap.release()

这种方式能保证输出帧数和原视频完全一致，且帧率沿用原视频的精确值，避免固定帧率带来的累计偏差。

2. 处理可变帧率（VFR）视频 #

如果原视频是VFR（多数MKV视频采用该格式），OpenCV的VideoWriter无法直接处理帧时间戳，此时建议用FFmpeg配合处理：

• 先用OpenCV处理所有帧，保存为序列图片：

import os
os.makedirs("frames", exist_ok=True)

cap = cv2.VideoCapture("example_video.mkv")
frame_idx = 0
while cap.isOpened():
    success, frame = cap.read()
    if success:
        # 分析并修改帧
        # * analyzing and modifying frame *
        cv2.imwrite(f"frames/frame_{frame_idx:06d}.png", frame)
        frame_idx += 1
    else:
        break
cap.release()

• 再用FFmpeg复用原视频的时间戳和音频，合并处理后的帧：

ffmpeg -i example_video.mkv -i frames/frame_%06d.png -map 0:a -map 1:v -c:a copy -c:v libx264 -copyts output.mp4

这条命令会直接沿用原视频的音频和时间轴，彻底解决音视频同步问题。

3. 验证输出一致性 #

处理完成后，用以下命令检查原视频与输出视频的参数：

# 查看原视频信息
ffmpeg -i example_video.mkv
# 查看输出视频信息
ffmpeg -i output.mp4

确认两者的总帧数、时长完全一致即可。

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