编码与格式 / 系统课时

安装 FFmpeg 并验证可用编解码器

安装 FFmpeg 并验证可用编解码器

安装 FFmpeg 后,不能只看到版本号就认为环境可用:不同安装包包含的编码器、解码器、封装格式和滤镜可能不同。本课将完成 Windows、macOS 或 Linux 环境安装,检查关键功能,并实际生成一段测试视频,确认音视频处理链路能够正常工作。

学习目标

  • 在常见操作系统中安装 FFmpeg,并确认命令行能够正确找到可执行文件。
  • 使用命令检查版本、编码器、解码器、封装格式和滤镜。
  • 生成测试视频并通过 FFprobe 验证输出,定位常见安装问题。

安装 FFmpeg 并配置命令行环境

FFmpeg 是跨平台音视频处理工具集。常用的三个命令分别是 ffmpeg(处理音视频)、ffprobe(分析媒体信息)和 ffplay(播放媒体,部分安装包可能不包含)。

FFmpeg 官方下载入口为 https://ffmpeg.org/download.html。官方网站主要发布源码,并提供第三方预编译版本的下载入口。初学者通常不需要从源码编译。

Windows 安装

以 Windows 10/11 的 64 位环境为例,可以采用预编译压缩包安装:

  1. 打开 FFmpeg 官方下载页面,在 Windows EXE Files 部分进入官方列出的构建提供商页面,例如 gyan.dev。
  2. 下载适合系统架构的 FFmpeg 预编译压缩包,例如 ffmpeg-release-essentials.zip。
  3. 将压缩包解压到固定位置,例如 C:\\tools\\ffmpeg,整理后确保 C:\\tools\\ffmpeg\\bin 中存在 ffmpeg.exe 和 ffprobe.exe。
  4. 打开「设置 → 系统 → 关于 → 高级系统设置 → 环境变量」,在用户变量或系统变量的 Path 中新增 C:\\tools\\ffmpeg\\bin。
  5. 保存设置,重新打开 PowerShell 终端。

运行以下命令确认系统找到的程序位置:

powershell
# 检查实际使用的 FFmpeg 路径
(Get-Command ffmpeg).Source
(Get-Command ffprobe).Source

预期输出(安装到示例目录时):

text
C:\tools\ffmpeg\bin\ffmpeg.exe
C:\tools\ffmpeg\bin\ffprobe.exe

如果实际解压目录不同,以对应的实际路径为准。注意 Path 应填写包含可执行文件的 bin 目录,而不是压缩包或 ffmpeg.exe 文件本身。

macOS 安装

已安装 Homebrew 的 macOS 用户可以直接执行:

bash
# 使用 Homebrew 安装 FFmpeg
brew install ffmpeg
command -v ffmpeg
command -v ffprobe

预期输出:最后两行分别显示 ffmpeg 与 ffprobe 的绝对路径。Apple Silicon 的常见前缀是 /opt/homebrew/bin,Intel Mac 的常见前缀是 /usr/local/bin,实际路径以 Homebrew 安装位置为准。

如果终端提示找不到 brew,先按照 https://brew.sh 的官方说明安装并初始化 Homebrew,再执行安装命令。

Linux 安装

Ubuntu 或 Debian 系统可以通过发行版软件仓库安装:

bash
# 刷新软件包索引并安装工具
sudo apt update
sudo apt install -y ffmpeg
command -v ffmpeg

预期输出:安装成功后最后一条命令返回类似 /usr/bin/ffmpeg 的路径。实际版本由发行版的软件仓库决定,不一定是 FFmpeg 官方最新版本。

查看版本与编译配置

完成安装后,先验证 FFmpeg 是否能够启动,以及所安装的二进制文件支持哪些外部库。

bash
# 输出版本、构建选项和依赖库版本
ffmpeg -version

预期输出(示意,版本和配置随安装来源变化):

text
ffmpeg version <VERSION>
built with <COMPILER>
configuration: <BUILD_OPTIONS>
libavutil      <LIBRARY_VERSION>
libavcodec     <LIBRARY_VERSION>
libavformat    <LIBRARY_VERSION>

其中 configuration 列出了编译选项。例如,出现 --enable-libx264 通常表示构建时启用了外部 x264 编码库支持;是否真正能调用对应编码器,仍应通过编码器列表确认。

如果需要逐项查看编译配置,可运行:

bash
ffmpeg -buildconf

预期输出:显示以 --enable-、--disable- 等参数为主的构建选项列表。部分构建选项涉及外部依赖,不能仅凭版本号判断某种编码能力是否存在。

检查编码器、解码器与封装格式

FFmpeg 的媒体处理能力可以拆分为三个不同层面:编解码器负责压缩或还原音视频数据;封装器负责把媒体流写入 MP4、MKV 等容器;解封装器则负责从容器中读取媒体流。

检查命令 检查对象 重点关注
ffmpeg -encoders 可用编码器 libx264、aac
ffmpeg -decoders 可用解码器 h264、aac
ffmpeg -codecs 已知编解码格式及能力 H.264、HEVC、AAC
ffmpeg -muxers 输出封装器 mp4、matroska
ffmpeg -demuxers 输入解封装器 mov,mp4,m4a,3gp,3g2,mj2、matroska,webm
ffmpeg -formats 输入及输出格式汇总 D 表示解封装,E 表示封装

先检查 H.264 编码器是否可用:

bash
# 查询指定编码器的详细信息
ffmpeg -h encoder=libx264

预期结果:安装包包含 libx264 时,会输出编码器名称、支持的像素格式和相关选项;如果没有编译进该编码器,则会出现类似 Codec 'libx264' is not recognized by FFmpeg. 的错误。

还可以分别执行以下命令:

bash
ffmpeg -encoders
ffmpeg -decoders
ffmpeg -muxers
ffmpeg -demuxers

预期结果:依次列出当前构建提供的编码器、解码器、输出封装器和输入解封装器。各项前面的能力标志与完整名称以终端实际显示为准。

例如,一个安装包可能可以读取 H.264 视频,但缺少某个特定的 H.264 编码实现。因此实际项目选型时必须同时验证输入解码和输出编码能力。

检查滤镜与媒体生成能力

滤镜负责缩放、裁剪、叠加、音量调整等处理。FFmpeg 还提供 lavfi 虚拟输入设备,可以直接通过滤镜生成测试画面与测试音频,不依赖摄像头或外部素材。

检查常用滤镜:

bash
# 分别查询视频缩放滤镜和测试画面源
ffmpeg -h filter=scale
ffmpeg -h filter=testsrc2

预期结果:终端显示 scale 和 testsrc2 滤镜的说明、输入输出要求及可用参数。如果提示 Unknown filter,说明当前构建不包含该滤镜或名称输入有误。

下面使用一个最小实验验证编码、封装和文件输出。该实验要求当前构建包含 testsrc2、mpeg4 编码器和 MP4 封装器。可以先通过前面的检查命令确认。

bash
# 生成 3 秒、320×240、25 fps 的测试视频
ffmpeg -hide_banner -f lavfi -i "testsrc2=size=320x240:rate=25" -t 3 -c:v mpeg4 -q:v 5 -pix_fmt yuv420p -y test.mp4

预期结果:命令执行成功,当前工作目录生成 test.mp4,终端输出包含输出流信息及最终媒体处理统计。编码期间通常能看到帧数、输出文件大小等动态数据,具体数值随构建版本变化。

此处选择内置 mpeg4 编码器,是为了减少对第三方编码库的依赖。它不是 H.264 编码器,也不意味着所有播放器都具有相同的 MPEG-4 Part 2 解码兼容性。

使用 FFprobe 验收并排查问题

文件成功生成不意味着参数一定正确,还需要使用 FFprobe 查看实际媒体流信息。

bash
# 输出视频编码名称、分辨率、帧率和容器时长
ffprobe -v error -select_streams v:0 -show_entries stream=codec_name,width,height,r_frame_rate -show_entries format=duration -of json test.mp4

预期输出(本实验常见结果):

json
{
  "streams": [
    {
      "codec_name": "mpeg4",
      "width": 320,
      "height": 240,
      "r_frame_rate": "25/1"
    }
  ],
  "format": {
    "duration": "3.000000"
  }
}

对照检查四项指标:视频编码为 mpeg4,宽度为 320,高度为 240,帧率为 25 fps,时长约为 3 秒。不同版本的字段排列及浮点数字符串可能有所不同。

如果生成或检查失败,按照以下顺序定位:

故障现象 常见原因 处理方法
找不到 ffmpeg 命令 未安装或 Path 未生效 检查可执行文件位置并重开终端
Unknown encoder 当前构建缺少编码器 执行 ffmpeg -encoders,改用可用编码器或更换构建
Unknown filter 滤镜未编译或名称错误 执行 ffmpeg -filters 检查
Requested output format 错误 输出封装器不可用或格式指定错误 检查 ffmpeg -muxers
Permission denied 输出目录不可写或文件被占用 切换可写目录并检查文件占用
FFprobe 找不到文件 工作目录与文件路径不一致 使用绝对路径或检查当前目录

需要确认多个 FFmpeg 安装版本是否冲突时,Windows PowerShell 使用 Get-Command ffmpeg -All,macOS 或 Linux 使用 type -a ffmpeg,查看命令解析到的具体程序路径。

实验通过的验收标准是:ffmpeg -version 正常显示版本,编码器与滤镜查询能够返回所需功能,测试文件生成成功,FFprobe 的媒体流参数符合要求。只有这些条件均满足,才能确认当前 FFmpeg 环境可以完成本课测试的音视频处理任务;后续使用 H.264、HEVC 或硬件加速时,仍需对目标编码器单独验证。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装 FFmpeg 并验证可用编解码器

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通