FFmpeg 项目全景导读：七大核心库、三大命令行工具、构建与许可证体系详解

FFmpeg 是处理音频、视频、字幕及相关元数据等多媒体内容的一套开源库与命令行工具集合。本篇以仓库根目录的 README.md 为骨架，逐层拆解其库体系、工具集、文档与示例组织方式、构建安装流程和许可证边界，并结合 Makefile、INSTALL.md、LICENSE.md 及 tools/、doc/examples/ 等目录的实际内容加以印证。读完后，你将能够准确理解 FFmpeg 各库的职责边界、定位关键源码位置，并完成源码级的构建、安装与二次开发。

一、FFmpeg 是什么：库与工具的双层结构

README 对项目的定位只有一句话：FFmpeg 是一组用于处理多媒体内容（音频、视频、字幕及相关元数据）的库和工具。

从仓库结构可以直接印证这一定位——根目录下的 lib*/ 目录对应七套可独立链接的库，而 fftools/ 与 tools/ 目录则构建出面向用户的命令行程序。当前仓库的版本号见 RELEASE 文件，内容为 8.0.git，表明这是 8.0 开发周期内的源码。

这种"库为核心、工具为壳"的分层设计意味着：

• 如果你要嵌入到自己的程序中，链接的是 libavcodec 等库，与 ffmpeg 命令行工具无关；
• 如果你只是做格式转换或批量处理，直接使用 ffmpeg、ffprobe 等工具即可，无需了解库 API；
• 仓库顶层 Makefile 中的 FFLIBS 变量按依赖顺序组织了全部库（avutil → swresample/swscale → avcodec → avformat → avfilter → avdevice），这本身就体现了库之间的分层依赖关系。

二、七大核心库：职责划分与源码位置

README 用七行要点概括了各库职责，这里逐条展开，并给出对应的源码目录，方便读者快速定位实现。

2.1 libavcodec：编解码器实现

• README 定位：提供范围广泛的编解码器（codecs）实现。
• 源码位置：libavcodec/。

这是 FFmpeg 中最大的库。进入该目录可以看到大量以编解码器命名的源文件，例如 aacdec.c/aacenc.c、ac3dec.c/ac3enc.c、flac.c、flacdec.c、flacenc.c、ffv1dec.c/ffv1enc.c、h26x/、hevc/、vvc/、opus/ 等子目录，涵盖了音频（AAC、MP3、FLAC、Opus、AC-3 等）和视频（H.264、HEVC、VVC、FFV1 等）编解码的独立实现。此外，该库还包含：

• cabac.c、cabac.h：H.264/HEVC 共用的 CABAC 熵解码；
• cbs/（Context-Based Structure）：如 libavcodec/cbs_h264.c、cbs_av1.c 等，用于按语法结构解析并修改比特流，供位流过滤器使用；
• aarch64/、arm/、x86/、riscv/、loongarch/、mips/、ppc/、wasm/ 等架构优化目录，说明各架构都有专门的汇编/DSP 加速实现；
• tests/：编解码器自身的测试程序。

2.2 libavformat：容器与流协议

• README 定位：实现流媒体协议、容器格式和基础 I/O 访问。
• 源码位置：libavformat/（约 700 个源文件）。

该库是"解复用/复用"层，把字节流变成带时间戳的分片（packet），也负责网络协议（HTTP、RTMP、HLS 等）的收发。它与 libavcodec 的分工是：libavformat 负责"装与拆"，libavcodec 负责"解与压"。

2.3 libavutil：基础工具集

• README 定位：包含哈希器、解压器和各类杂项工具函数。
• 源码位置：libavutil/（约 450 个文件）。

这是所有其他库的公共依赖（顶层 Makefile 中 FFLIBS := avutil 单独成行，表示它位于依赖链最底层）。典型内容如 av_log 日志系统、AVFrame/AVPacket 数据结构、像素格式定义、内存与数学工具等。任何基于 FFmpeg 二次开发的程序都会大量接触这个库的头文件。

2.4 libavfilter：滤镜图

• README 定位：通过有向图（directed graph）连接的滤镜来改变解码后的音频和视频。
• 源码位置：libavfilter/（约 800 个文件，是文件数最多的库目录）。

"滤镜图"是其核心抽象：每个 vf_*（视频滤镜）或 af_*（音频滤镜）文件是一个节点，ffmpeg 命令行的 -filter_complex 参数就是在描述这张有向图。目录中的 .glsl、.cl、.cu 文件则说明部分滤镜提供了 Vulkan、OpenCL、CUDA 等 GPU 加速实现。

2.5 libavdevice：设备抽象

• README 定位：提供访问采集与播放设备的抽象层。
• 源码位置：libavdevice/。

它将 ALSA、PulseAudio、V4L2、AVFoundation、dshow 等各平台设备差异统一为一套 demuxer/muxer 接口，因此 ffmpeg -f v4l2 -i /dev/video0 ... 这类采集命令才能在跨平台场景下复用同一套逻辑。

2.6 libswresample 与 libswscale：采样与缩放

• libswresample：实现音频混音（mixing）与重采样（resampling）。源码位于 libswresample/，约 47 个文件，规模较小但独立成库。
• libswscale：实现色彩空间转换与视频缩放。源码位于 libswscale/，含大量 x86/、arm/ 等架构优化实现。

README 将这两个库单列出来而非并入 libavcodec，正是因为它们承担的是"帧级像素/样本操作"，与"比特流编解码"职责不同，且可被单独裁剪使用。

三、命令行工具：fftools 与辅助工具

3.1 三大主力工具

README 的 Tools 一节列出了三个核心工具，源码均位于 fftools/ 目录：

工具	定位（README 原文）	入口文件
ffmpeg	命令行工具箱，用于操作、转换和流式传输多媒体内容	fftools/ffmpeg.c
ffplay	极简的多媒体播放器	fftools/ffplay.c
ffprobe	简单的分析工具，用于检查多媒体内容	fftools/ffprobe.c

从 fftools/ 目录的文件组织还能看到 ffmpeg 工具内部的结构化拆分：ffmpeg_demux.c（解复用）、ffmpeg_dec.c（解码）、ffmpeg_filter.c（滤镜）、ffmpeg_enc.c（编码）、ffmpeg_mux.c（复用）、ffmpeg_hw.c（硬件加速）、ffmpeg_sched.c（调度）等，文件头注释也自述为 "multimedia converter based on the FFmpeg libraries"。也就是说，ffmpeg 本身只是一层薄薄的编排层，真正的多媒体能力全部来自第二节所述的七个库——这再次印证了"库为核心"的架构。

3.2 附加小工具

README 还提到 aviocat、ismindex、qt-faststart 等附加小工具，它们位于 tools/ 目录，对应源文件为：

• tools/aviocat.c：将多个 AVI 文件拼接为一个；
• tools/ismindex.c：为 Smooth Streaming 生成索引；
• tools/qt-faststart.c：将 MP4 的 moov 原子前置以支持流式播放。

tools/ 目录中还包含大量开发辅助程序：ffescape.c、ffeval.c、fourcc2pixfmt.c、graph2dot.c（滤镜图可视化）、ffhash.c，以及一组 target_*_fuzzer.c 模糊测试入口（顶层 Makefile 中定义了它们的链接规则）。这些程序虽不随 make install 作为主工具分发，但对调试与质量保障非常有用。

四、文档与编码示例：doc/ 目录的组织方式

README 的 Documentation 一节指出：离线文档位于 doc/ 目录，编码示例位于 doc/examples/ 目录。

4.1 离线文档体系

doc/ 目录包含大量 .texi 文件，按主题划分：ffmpeg.texi、ffprobe.texi、ffplay.texi（三大工具手册）、codecs.texi、formats.texi、protocols.texi、filters.texi（滤镜参考）、libavcodec.texi、libavformat.texi 等（各库的 API 手册）、optimization.txt（优化指南）、multithreading.txt（多线程模型说明）以及 fate.texi（FATE 测试框架文档）。此外还有 doc/APIchanges 记录公共 API 的变更历史，doc/ffmpeg.txt 等纯文本版本便于快速检索。

4.2 doc/examples 示例代码

doc/examples/ 目录提供 20 余个 C 语言示例，每个示例都是一个完整的"库 API 用法切片"：

• transcode.c：完整转码流程（解复用→解码→缩放/重采样→编码→复用），是最值得精读的综合示例；
• decode_video.c / encode_video.c / decode_audio.c / encode_audio.c：单一方向的读写；
• filter_audio.c / filter_video.c（目录中为 decode_filter_audio.c/decode_filter_video.c）：经滤镜图处理；
• remux.c：仅复用（stream copy）；
• scale_video.c / resample_audio.c：单库用法；
• hw_decode.c、vaapi_encode.c、vaapi_transcode.c、qsv_decode.c、qsv_transcode.c：硬件加速路径；
• avio_http_serve_files.c、avio_list_dir.c、avio_read_callback.c：libavformat 的 avio 自定义 I/O 回调。

编译方式由 doc/examples/README 明确给出两条路径：

1. 系统已安装 FFmpeg 时：将示例拷入用户目录后执行

   make -f Makefile.example
   

   依赖 pkg-config 和 make，通过 PKG_CONFIG_PATH 定位库；

2. 源码树内构建：先 make 构建 FFmpeg（无需 make install），然后直接

   make examples
   

   用 FFmpeg 自身构建系统编译示例，make examplesclean 清理。若想在源码树内模拟方式一，可进入 doc/examples 执行 PKG_CONFIG_PATH=pc-uninstalled make -f Makefile.example。

五、构建与安装：configure + make 三步流程

README 本身不含构建细节，但仓库根目录的 INSTALL.md 给出了完整的标准流程，这里完整保留其操作步骤并补充上下文：

5.1 标准三步（可选第四步）

步骤 0（可选）：合并源码插件

tools/merge-all-source-plugins

如需包含源码插件（source plugins），应在 configure 之前先合并。该脚本位于 tools/merge-all-source-plugins，插件清单由 tools/source-plugins.txt 维护。

步骤 1：configure 生成配置

./configure

• 所有 configure 选项通过 configure --help 查看；
• configure 可以在不同于源码目录的目录下运行以实现 out-of-tree 构建，此时需用绝对路径启动，例如 /ffmpegdir/ffmpeg/configure。

步骤 2：make 构建

make

需要 GNU Make 3.81 或更高版本。

步骤 3：make install 安装

make install

安装所有构建出的二进制与库。安装内容（DATA_FILES）除库文件外还包括 presets/*.ffpreset 预设文件与 doc/ffprobe.xsd。

5.2 两条重要注意事项

INSTALL.md 特别提示：

• 非系统依赖默认全部禁用（例如 libx264、libvpx 等第三方编码库），默认构建只使用 FFmpeg 自带实现，这是构建结果"开箱即用但不含外部编码器"的原因；
• 给包管理者的建议：推荐两次构建 FFmpeg——第一次以最小外部依赖构建，使依赖 libavutil/libavfilter/libavcodec/libavformat 的第三方包得以先行构建；第二次再以完整依赖构建。这样可以避免构建期的循环依赖。

六、许可证体系：LGPL 为主，GPL 与 Non-free 可选

README 的 License 一节简要说明"FFmpeg 代码库主要为 LGPL 许可，可选组件为 GPL"。LICENSE.md 给出了完整边界，这也是使用者必须了解的合规要点：

6.1 默认许可证：LGPL v2.1+

绝大多数文件位于 LGPL v2.1 或之后版本（见 COPYING.LGPLv2.1），另有少量文件采用 MIT/X11/BSD 风格许可，整体上 FFmpeg 适用 LGPL v2.1+。

6.2 可选的 GPL 部分

一部分可选功能采用 GPL v2+（见 COPYING.GPLv2），默认不参与构建，必须显式向 configure 传 --enable-gpl 才启用，且启用后整体许可证升级为 GPL v2+。GPL 部分包括：

• 部分 x86 优化文件，如 libavcodec/x86/flac_dsp_gpl.asm、libavcodec/x86/idct_mmx.c、libavfilter/x86/vf_removegrain.asm；
• 一批构建/测试工具（compat/solaris/make_sunver.pl、doc/t2h.pm、doc/texi2pod.pl、tests/checkasm/、tests/tiny_ssim.c 等）；
• libavfilter 中约三十个滤镜（vf_blackframe.c、vf_boxblur.c、vf_cropdetect.c、vf_delogo.c、vf_eq.c、vf_hqdn3d.c、vf_mcdeint.c、vf_pullup.c、vf_stereo3d.c 等，完整清单见 LICENSE.md）。

6.3 --enable-version3 与 --enable-nonfree

• --enable-version3：将许可证升级为 v3 变体（COPYING.LGPLv3 或 COPYING.GPLv3）。使用 gmp、libaribb24、liblensfun 等 LGPL v3 库，或与 Apache 2.0 许可的 VMAF、mbedTLS、RK MPI 等库组合时必须开启；
• --enable-nonfree：用于启用许可证与 GPL/LGPL 不兼容的外部库（如 Fraunhofer FDK AAC、OpenSSL 相关集成），开启后产物不可再分发（unredistributable），只能自用。

6.4 特殊许可文件

libavcodec/jfdctfst.c、libavcodec/jfdctint_template.c、libavcodec/jrevdct.c 源自 libjpeg，单独分发可执行文件时需在文档中注明 IJG 贡献并说明对这些文件的改动。

七、贡献流程与开发协作

README 的 Contributing 一节明确了上游的贡献规范：

• 补丁应通过 git format-patch 或 git send-email 提交到 ffmpeg-devel 邮件列表；
• 应避免使用 GitHub Pull Request——PR 不在其审查流程之内，会被忽略。

仓库内也提供了配套工具：tools/patcheck（补丁检查脚本）、tools/clean-diff 与 tools/unwrap-diff（整理 diff 格式）、tools/check_commit_msg.sh（提交信息规范检查）。这些脚本的存在印证了邮件列表工作流在工程上的支撑。

八、仓库结构速查表

最后以一张速查表汇总 README 各要点与仓库目录的对应关系，方便按图索骥：

主题	入口位置
七库源码	libavcodec/、libavformat/、libavutil/、libavfilter/、libavdevice/、libswresample/、libswscale/
三大工具	fftools/ffmpeg.c、fftools/ffplay.c、fftools/ffprobe.c
附加工具	tools/aviocat.c、tools/ismindex.c、tools/qt-faststart.c
离线文档	doc/（texi 手册与 txt 指南）
编码示例	doc/examples/（20 余个 C 示例 + doc/examples/README 编译说明）
构建入口	configure、Makefile、INSTALL.md
许可证	LICENSE.md、COPYING.LGPLv2.1、COPYING.GPLv2 等
版本号	RELEASE（8.0.git）

综合来看，FFmpeg 的价值在于将"编解码、容器、滤镜、设备、色彩/采样转换"完整封装为可裁剪的七库体系，并以 ffmpeg/ffplay/ffprobe 三个工具暴露统一的用户入口；二次开发者可直接研读 doc/examples/ 的示例切入库 API，构建与发行则遵循 configure + make 的标准流程，并按需通过 --enable-gpl、--enable-version3、--enable-nonfree 在功能与许可证约束之间取得平衡。