2.1 模块化架构：六大库各司其职

2.1 模块化架构：六大库各司其职

本节摘要：FFmpeg 由六个核心库组成，分别负责管线的一段。本节逐一拆解 libavformat、libavcodec、libavfilter 等库的职责边界，并用「改封装不改编码」的实际例子说明模块化如何带来效率与灵活。

本节目标：阅读完本节，你应当能够：

1. 说出六大库的名称与职责，画出库与管线段的一一对应
2. 用 -c copy 完成一次「只改容器」的秒级转换，并解释它为什么快
3. 判断一个具体任务应该落在哪个库的职责范围内

一、一个反例开场

先看一个反面教材：有人想给视频换容器格式，把 MP4 转成 MKV，写了一条「老老实实」的命令：

# 错误示范：MP4 转 MKV，连编解码都重新来了一遍
ffmpeg -i input.mp4 -vcodec libx264 -acodec aac output.mkv
​

这条命令能跑，但慢得离谱——10 分钟的视频可能要转十几分钟，画质还可能二次损伤。问题出在哪？它把整个管线从头到尾重跑了一遍：解码、重新编码、再封装。而 MP4 和 MKV 都是容器，里面的 H.264/AAC 数据完全可以原样搬过去。

正确姿势是只换容器，不碰编码数据：

# 正确示范：只改容器，复制编码数据
ffmpeg -i input.mp4 -c copy output.mkv
​

-c copy 告诉 FFmpeg「编码流原样拷贝」。这条命令几秒钟就能完成，因为整个 libavcodec（编解码）环节被绕过了，只有 libavformat（封装）在干活。这个例子把「模块化」的价值说透了：每个库只管自己的一段，你可以只动需要的部分。

二、六大库的职责边界

FFmpeg 的核心由六个库组成，它们拼在一起覆盖了第 1 章的整条管线：

• libavutil：地基中的地基。提供内存分配、数学工具、日志、数据结构等公共能力。其他五个库都依赖它，但它不依赖别人。你可以把它理解为「公用工具箱」。
• libavformat：管封装与解封装。它负责从文件或网络流里读出容器、拆出各条流（demux），也负责把流写回容器（mux）。第 1 章说的「容器」，就是它的主场。
• libavcodec：管编解码。负责把压缩数据（AVPacket）解成原始帧（AVFrame），也负责把原始帧压回压缩数据。H.264、HEVC、AAC、MP3 这些编解码器的实现都在这。
• libavfilter：管滤镜。负责在原始帧上做各种处理——缩放、裁剪、水印、模糊、混音，第 4 章会细讲。它只处理「解出来的原始数据」，不碰压缩数据。
• libswscale：管图像转换。像素格式转换（yuv420p 转 rgb24）、分辨率缩放、色彩空间转换。它解决的问题是「原始帧长得不一样，怎么互相喂」。
• libswresample：管音频重采样。采样率转换（48kHz 转 44.1kHz）、声道布局变换（立体声转单声道）、样本格式转换。功能跟 libswscale 对称，一个管画面一个管声音。

下面这张图把六个库放到管线上，一眼看清谁管哪段。

图说明：边界清楚，组合自由

注意图中 libavutil 在最中间偏下的位置——它支撑全部库。管线主段由 format、codec、filter 三个库承担，scale 与 resample 是「换插头」的适配器。这套设计保证了「换容器不碰编解码」这类部分替换成为可能，也决定了命令行的 -f、-c、-vf 选项分别对应哪个库。

三、工程实践要点

理解了库的边界，命令行就能「对症下药」：

• 只换容器：-c copy，走 libavformat，快。
• 只改编码：-c:v libx264，走 libavcodec，慢但可控。
• 只加滤镜：-vf "scale=...:..."，走 libavfilter，在解码后编码前插入。
• 要改分辨率/像素格式：涉及 libswscale，通常在滤镜链里用 scale 滤镜完成。
• 要改采样率/声道：涉及 libswresample，音频滤镜里用 aresample 完成。

实际项目里最常见的性能问题是「无谓的完整转码」——只改了个封面就整条管线重跑。判断依据很简单：数据形态变了吗？ 只换容器，数据形态（压缩包）没变，-c copy；要改画面尺寸，原始帧必须变，只能解码重编码。

⚠️ 常见坑：-c copy 不是万能胶。如果源流的编码不被目标容器支持（比如把 HEVC 流塞进老旧的 AVI），拷贝会失败或产出坏文件。任何 -c copy 前，先确认目标容器接受源编码。

💡 关键直觉：先问「我要改的是数据形态，还是只换包装？」形态没变 → copy；形态变了 → 转码。这个判断能帮你避开 80% 的性能浪费。

库的边界在命令行里怎么体现

六个库的职责不是纸上谈兵，每条命令的参数都对应着一个库的接口。-f 指定容器格式，走的是 libavformat；-c:v 指定视频编码器，走的是 libavcodec；-vf 写滤镜链，走的是 libavfilter。当你看到一条命令同时出现 -f mp4 -c:v libx264 -vf scale 时，其实是在同时指挥三个库协同。

反向排查也成立：报错信息里出现 Unknown format，问题在 libavformat 层；出现 Unknown encoder，问题在 libavcodec 层；出现滤镜相关的语法错误，问题在 libavfilter 层。学会把报错映射到库，排错速度会快很多——你不再对着整条命令发懵，而是直接锁定出问题的那个模块。

本节要点回顾

• 六大库各管一段：format 管封装、codec 管编解码、filter 管滤镜、util 是地基、scale/resample 是音画适配器
• 模块化的红利：库与管线段一一对应，让你可以只动需要的那一段，其余原样搬运
• -c copy 的原理：绕过编解码，只走封装，所以秒级完成；代价是目标容器必须支持源编码
• 命令行即结构：-f、-c、-vf 这些选项名直接指向对应的库，理解结构后参数不再是死记
• 判断依据：数据形态是否改变，决定该 copy 还是该转码

下一节看数据在这六个库之间到底以什么结构流动——AVPacket 与 AVFrame 的分工。