ffmpeg-python是FFmpeg的轻量惰性封装，支持链式语法与完整选项，不立即执行而拼接命令后单次调用，兼顾性能与可编程性；相比OpenCV（帧级低效）和moviepy（抽象高、调试难），它复用系统FFmpeg、支持硬件加速、微秒级精准剪辑、无损流复制及复杂滤镜。
用 Python 做视频剪辑，不一定要调用系统命令或写一堆 subprocess；FFmpeg 的 Python 绑定（如 ffmpeg-python）能让你在纯 Python 环境中完成精准、可编程的剪辑操作，同时保持 FFmpeg 的高性能和丰富功能。
为什么选 ffmpeg-python 而不是 OpenCV 或 moviepy？
OpenCV 适合帧级处理但编码效率低、格式支持弱；moviepy 抽象高但底层依赖 ImageMagick + FFmpeg，调试困难且内存开销大。而 ffmpeg-python 是对 FFmpeg CLI 的轻量级、惰性构建式封装：它不立即执行，而是拼接命令行参数，最后调用一次 ffmpeg 进程，既保留原生性能，又支持链式语法和完整选项。
- 直接复用系统已安装的 FFmpeg（支持硬件加速、新编码器）
- 无中间文件、无重复解码，剪辑 2 小时视频只需毫秒级命令构建
- 可精确到微秒（-ss 配合 -to 或 -t），支持关键帧对齐与无损流复制
安装与基础剪辑：从 0 到 10 秒片段
先确保已安装 FFmpeg（必须），再安装绑定：
pip install ffmpeg-python
以下代码从 input.mp4 中截取第 30 秒开始、持续 10 秒的片段，并启用流复制（零重编码，秒级完成）：
立即学习“Python免费学习笔记（深入）”；
import ffmpeg
try:
(ffmpeg
.input('input.mp4', ss='00:00:30') # 精确到秒或'30.5'
.output('output.mp4', t='10', c='copy') # t=duration, c=copy 表示不重编码
.run(overwrite_output=True))
except ffmpeg.Error as e:
print('FFmpeg error:', e.stderr.decode())
- ss 放 input 前：实现关键帧就近跳转，快且兼容性好
- t 或 to：t='10' 表示时长；to='00:00:40' 表示结束时间点
- c='copy' 仅适用于输入与输出编码格式兼容（如 H.264 → H.264）
高级剪辑：多段拼接、音频分离、变速与条件裁剪
真正实用的剪辑常需组合操作。ffmpeg-python 支持复杂图构建，例如「提取 3 段视频 + 静音音频 + 拼成一个文件」：
# 提取三段（支持不同起止时间）
inputs = [
ffmpeg.input('input.mp4', ss='00:01:00', t='00:00:05'),
ffmpeg.input('input.mp4', ss='00:02:30', t='00:00:08'),
ffmpeg.input('input.mp4', ss='00:04:15', t='00:00:03'),
]
# 拼接（concat demuxer，要求格式一致）
joined = ffmpeg.concat(*inputs, v=1, a=1).node
out = ffmpeg.output(joined[0], joined[1], 'final.mp4')
out.run(overwrite_output=True)
- 用 concat 实现无损拼接，比写临时文件 + list.txt 更简洁
- 加 af='volume=0' 可静音；加 vf='setpts=0.5*PTS' 实现 2x 快放
- 用 filter_complex 可写多路滤镜（如画中画、淡入淡出），语法与 FFmpeg CLI 完全一致
错误规避与生产建议
实际项目中常见问题不是功能不会用，而是边界没处理好：
-
视频时长未知？先用 ffprobe 获取元信息：
ffmpeg.probe('input.mp4')['format']['duration'] - 剪辑后黑屏/无声？检查是否误用
c='copy'导致音视频流不匹配；改用c:v='libx264', c:a='aac'强制重编码 - Windows 上中文路径报错？用
os.path.abspath()转绝对路径，避免编码歧义 - 需要日志或进度？传参
capture_stdout=True, capture_stderr=True，再解析 stderr 中的 time= 字段
