玩转音视频处理，PyAV 模块真香
做音视频处理时，FFmpeg 是绕不开的工具。但直接在 Python 里调用命令行，总感觉不够优雅。PyAV 这个模块，相当于给 FFmpeg 套上了 Python 的外衣，让我们能用熟悉的语法去操作容器、流、帧这些概念。无论是做视频剪辑、格式转换，还是抽帧分析，PyAV 都能派上大用场。
🎬 打开视频文件，读取基本信息
想处理视频，第一步当然是打开文件。PyAV 的 open 方法会解析视频容器，把流信息整理得清清楚楚。
import avwith av.open('demo.mp4') as container: video_stream = container.streams.video[0]print(f"分辨率: {video_stream.width}x{video_stream.height}")print(f"帧率: {video_stream.average_rate}")print(f"总帧数: {video_stream.frames}")
运行结果：
分辨率: 1920x1080帧率: 30/1总帧数: 3000
🖼️ 逐帧遍历，提取关键画面
很多场景下我们需要提取视频里的每一帧，比如做视频内容分析。PyAV 的 decode 方法会按顺序吐出帧对象。
with av.open('demo.mp4') as container:for frame in container.decode(video=0):if frame.time < 3.0: # 只取前3秒 img = frame.to_image()print(f"时间点: {frame.time:.2f}秒, 尺寸: {img.size}")
运行结果：
时间点: 0.00秒, 尺寸: (1920, 1080)时间点: 0.03秒, 尺寸: (1920, 1080)时间点: 0.07秒, 尺寸: (1920, 1080)...（省略中间重复输出）
✂️ 精准裁剪，输出新视频
利用时间戳过滤帧，可以轻松实现视频裁剪。下面这个例子演示了如何截取 5 到 10 秒的片段，并写入新文件。
with av.open('demo.mp4') as infile: out_container = av.open('clip.mp4', 'w') out_stream = out_container.add_stream('h264', rate=30)for frame in infile.decode(video=0):if5.0 <= frame.time <= 10.0:for packet in out_stream.encode(frame): out_container.mux(packet) out_container.close()
代码不复杂，逻辑很清晰：边读边判断时间范围，符合条件就编码后写入。执行完你就会看到当前目录下生成了 clip.mp4 文件，长度正好 5 秒。
🎞️ 批量抽帧，保存为图片
视频分析和模型训练经常需要大量图片素材。PyAV 配合 PIL 能一条龙搞定帧转图片的活儿。
from PIL import Imagewith av.open('demo.mp4') as container:for i, frame inenumerate(container.decode(video=0)):if i % 30 == 0: # 每隔30帧取一张 img = frame.to_image() img.save(f'frame_{i:04d}.jpg')print(f"已保存: frame_{i:04d}.jpg")
运行结果：
已保存: frame_0000.jpg已保存: frame_0030.jpg已保存: frame_0060.jpg...（继续输出）
⚔️ PyAV vs 其他模块
相比 moviepy（封装度高但效率一般）和 ffmpeg-python（只是命令行的包装），PyAV 的优势在于直接操作底层数据流，内存占用更可控，适合做高性能服务。缺点是文档比较零散，新手入门曲线稍陡。建议：批量转码选 PyAV，快速剪辑用 moviepy，想省事直接调 subprocess 跑 FFmpeg 命令也行。
📢 写在最后
PyAV 把 FFmpeg 的威力带到了 Python 世界，学会它就像多了一把音视频处理的瑞士军刀。从打开文件、遍历帧，到裁剪片段、导出图片，这套组合拳足够覆盖日常大部分需求。如果你在实际项目中用过 PyAV，或者有踩过的坑，欢迎在评论区分享出来，大家一起交流进步～
