用 ffmpeg-python 修复损坏视频：4 种场景的完整工作流

【免费下载链接】ffmpeg-pythonPython bindings for FFmpeg - with complex filtering support项目地址: https://gitcode.com/gh_mirrors/ff/ffmpeg-python

视频文件损坏却不知道怎么下手修？ffmpeg-python 用链式 Python 接口把 FFmpeg 的重封装、错误隐藏、时间戳对齐这些修复能力变成几行代码，新手也能搭出完整的视频修复工作流。

一、30 秒装好 ffmpeg-python

先确认系统里装好了 FFmpeg，再一行命令装上这个 Python 绑定：

pip install ffmpeg-python # 或：git clone https://gitcode.com/gh_mirrors/ff/ffmpeg-python 后执行 pip install .

二、四种典型损坏，四种解法

文件头 / 容器损坏怎么修：重封装到健康容器

播放时报"格式不支持"或"文件已损坏"，但画面其实能解出来，多半是容器头坏了。在 output 里写 vcodec='copy'、acodec='copy'，把音视频流原样拷进新的 mp4，不重编码、不丢帧。

关键帧丢失怎么修：插值重建加错误隐藏

某一段画面花屏、卡住，说明 I 帧丢了。在 output 加 ec='1' 让解码器启用错误隐藏，用相邻帧把破损宏块补出来，重编码后画面就能连续。

音画不同步怎么修：时间戳对齐

声音比画面快或慢，用 asetpts 把音频 PTS 重置成 PTS-STARTPTS，或用 setpts 校正视频时间戳，把两条流拉回同一时间轴再合并输出。

部分片段不可读怎么修：选择性截取修复

只有前几秒或中间某段能播时，用 ss、t 参数只截取完好区间，跳过坏块，输出一个干净的新文件，保住能救的内容。

三、从诊断到修复：一条完整流水线

步骤一：ffprobe 诊断一条命令

先用 probe() 拿到损坏文件的元数据，看容器、时长、各流编码与帧数，定位问题出在哪一层：

info = ffmpeg.probe('damaged.mp4') # 看 info['format']（容器/时长）与 info['streams']（编码/分辨率/帧数）

步骤二：策略匹配

按探测结果分流：format 读不出来就走重封装；streams 里视频流有损就上 ec='1' 错误隐藏；音视频时长明显不等就对齐时间戳；只有部分可解码就选择性截取。

步骤三：执行与校验

执行修复命令，再用 probe() 重新扫一遍输出文件，确认时长、流数、帧数都符合预期：

(ffmpeg.input('bad.mp4', ss=120, t=60) .output('fixed.mp4', crf=18) .overwrite_output() .run())

最后抽几帧看一眼，没有花屏、声音对齐，这次修复才算过关。

四、三个容易踩的坑

坑一：跳过 ffprobe 直接修。不看损坏类型就套参数，容易把能重封装的活做成全量重编码，白白损失画质。先 probe 再选路径。

坑二：批量修复没做输出目录隔离。几十个文件一起跑，输出名相撞会互相覆盖。每个文件落到独立子目录，命名带上原文件名。

坑三：忽略编码参数导致二次损坏。重编码时不写 pix_fmt='yuv420p'、不设 crf 上限，兼容性反而更差。显式指定这两个参数。

五、下一步

• 官方文档 doc/：完整 API 参考，重点看 probe、input、output 三个入口。
• 示例目录 examples/：含 video_info.py 等可直接跑的诊断脚本。
• 测试用例 ffmpeg/tests/：展示真实文件上的各种处理场景。

【免费下载链接】ffmpeg-pythonPython bindings for FFmpeg - with complex filtering support项目地址: https://gitcode.com/gh_mirrors/ff/ffmpeg-python