macOS 上使用 Homebrew 安装 FFmpeg 详细指南
引言：强大的 FFmpeg 与便捷的 Homebrew
在数字媒体日益普及的今天，处理音频和视频文件已成为许多用户和专业人士的日常需求。无论是进行格式转换、剪辑、编码、解码、流媒体传输，还是进行复杂的滤镜处理，一个强大而灵活的工具必不可少。FFmpeg 正是这样的一个工具——它是一个开源的、跨平台的命令行工具集合，能够处理几乎所有的音频和视频格式。它的核心是 ffmpeg 命令行程序，但也包含用于处理多媒体流的 ffplay 和用于检查多媒体文件信息的 ffprobe 等实用程序。
对于 macOS 用户来说，安装像 FFmpeg 这样复杂的开源软件通常需要处理大量的依赖库和编译过程，这可能会非常繁琐且容易出错。幸运的是，macOS 拥有一个优秀的包管理器叫做 Homebrew。Homebrew 被誉为“macOS 缺失的包管理器”，它极大地简化了在 macOS 上安装、更新和管理各种开源软件的过程。通过 Homebrew，用户可以通过简单的命令安装成千上万的开源工具，Homebrew 会自动处理复杂的依赖关系，并在后台完成下载、编译和安装的工作。
将 Homebrew 与 FFmpeg 结合使用，为 macOS 用户提供了一条最简单、最可靠的途径来获取并使用这个强大的多媒体处理工具。本文将详细介绍如何在 macOS 上使用 Homebrew 安装 FFmpeg，包括准备工作、安装步骤、验证、基本使用、更新、卸载以及一些常见问题的解决方案。我们将深入探讨每一步骤的细节，确保您能顺利地在您的 Mac 上部署并利用 FFmpeg。
第一部分：安装前的准备工作
在开始安装 FFmpeg 之前，您需要确保您的 macOS 系统满足一些基本要求，并且已经安装了 Homebrew。
1. 确保 macOS 系统更新
虽然 FFmpeg 和 Homebrew 通常兼容较旧的 macOS 版本，但为了获得最佳的兼容性、性能和安全性，建议您的 macOS 系统保持最新。您可以通过“系统设置”（在旧版本 macOS 中是“系统偏好设置”）-> “软件更新”来检查并安装任何可用的更新。
2. 安装 Xcode Command Line Tools
Homebrew 本身以及许多通过 Homebrew 安装的软件（包括 FFmpeg 及其依赖项）可能需要编译。编译过程依赖于苹果提供的开发者工具集，即 Xcode Command Line Tools。即使您没有安装完整的 Xcode 应用，通常也需要安装 Command Line Tools。
如何检查是否已安装：
打开“终端”（Terminal）应用程序。您可以在“应用程序”->“实用工具”文件夹中找到它，或者使用 Spotlight 搜索（Command + Space，输入 Terminal）。
在终端中输入以下命令并按回车：
bash
xcode-select --version
如果 Command Line Tools 已经安装，您会看到类似 xcode-select version 2399. 这样的输出（版本号可能不同）。
如果未安装或版本过旧：
在终端中输入以下命令并按回车：
bash
xcode-select --install
这会弹出一个软件许可协议窗口，您需要点击“安装”并同意协议。系统会自动下载并安装 Command Line Tools。这个过程可能需要一些时间，取决于您的网络速度。
如果出现“command line tools are already installed”的提示，说明您已经安装过了。
3. 安装 Homebrew
如果您还没有安装 Homebrew，现在是时候安装它了。Homebrew 的安装脚本会自动检测并满足其运行所需的环境（例如，检查是否安装了 Command Line Tools）。
如何检查是否已安装 Homebrew：
在终端中输入以下命令并按回车：
bash
brew --version
如果 Homebrew 已经安装，您会看到类似 Homebrew 4.1.0 或更高版本的输出。
如果未安装：
访问 Homebrew 的官方网站 (https://brew.sh/) 获取最新的安装命令。通常，安装命令如下：
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
重要提示： 在执行任何从互联网下载并运行的脚本之前，了解其作用是谨慎的做法。Homebrew 的安装脚本是公开的，并且被广泛使用和审查。它会下载 Homebrew 的核心文件，设置必要的环境变量，并将 Homebrew 的可执行路径添加到您的 Shell 的 PATH 中，以便您可以在任何地方运行 brew 命令。
将上述命令粘贴到您的终端中，然后按回车。安装脚本会提示您输入用户密码（在您输入时不会显示字符）以授权安装。它还会列出将要执行的操作，并可能需要您按回车确认。
安装过程可能需要一些时间，取决于您的网络连接。安装完成后，Homebrew 会提示您运行一些命令（通常是添加到 PATH 的说明），请按照提示操作。在某些较新的 macOS 系统上，Homebrew 可能会提示您在 ~/.zshrc 或 ~/.bash_profile 文件中添加一行配置来将 brew 命令添加到系统路径中。请务必执行这些命令，或者手动编辑文件，然后重新加载您的 Shell 配置（例如，关闭并重新打开终端，或运行 source ~/.zshrc 或 source ~/.bash_profile）。
验证 Homebrew 安装：
安装完成后，再次运行 brew --version 命令，应该能看到版本信息。
接着，运行 brew doctor 命令。
bash
brew doctor
这个命令会检查您的 Homebrew 环境是否存在潜在问题（例如，权限问题、过时的文件、不兼容的环境变量等）。如果一切正常，它会输出 Your system is ready to brew. 如果有警告或错误，请按照提示信息进行修复。解决 brew doctor 报告的问题有助于确保后续的软件安装顺利进行。
至此，您已经完成了 Homebrew 和其依赖环境的准备工作。
第二部分：理解 Homebrew 安装 FFmpeg
在使用 brew install ffmpeg 命令之前，了解 Homebrew 如何管理软件以及 FFmpeg 为什么如此复杂（以及 Homebrew 如何简化它）会非常有帮助。
1. Homebrew 的工作原理
Homebrew 使用一种叫做“Formula”（配方）的文件来描述如何下载、配置、编译和安装一个软件。这些 Formula 是 Ruby 脚本，存储在 Homebrew 的 GitHub 仓库中。当您运行 brew install <formula_name> 时，Homebrew 会：
- 查找对应的 Formula。
- 读取 Formula 文件，了解软件的来源（下载链接）、版本、编译选项、以及最重要的——依赖项。
- 检查您的系统是否已经安装了所有依赖项。如果某个依赖项尚未安装，Homebrew 会递归地先安装这些依赖项。
- 下载软件的源代码或预编译的二进制文件（如果 Formula 提供了）。
- 根据 Formula 中指定的步骤，配置、编译（如果下载的是源代码）并安装软件到 Homebrew 的安装目录（通常是
/usr/local或/opt/homebrew，取决于您的 Mac 芯片类型）。 - 将安装的软件的可执行文件创建软链接到 Homebrew 的 bin 目录（通常是
/usr/local/bin或/opt/homebrew/bin），这个目录通常已经被添加到了您的系统 PATH 环境变量中，因此您可以在终端的任何位置直接运行该软件的命令。
2. FFmpeg 的复杂性与依赖项
FFmpeg 本身是一个框架，它依赖于大量的第三方库来实现对各种音视频格式的支持。例如，处理 H.264 视频需要 libx264 库，处理 MP3 音频需要 libmp3lame 库，处理 VP9 视频需要 libvpx 库，等等。这些库本身也可能有自己的依赖。手动安装 FFmpeg 意味着您需要手动寻找、下载、编译并安装所有这些依赖库，这非常耗时且容易出错。
Homebrew 的强大之处在于它完全自动化了这个过程。当您运行 brew install ffmpeg 时，Homebrew 会查看 FFmpeg Formula 中列出的所有依赖项，如果您的系统上没有这些依赖项，Homebrew 会自动先去下载并安装它们，然后才开始安装 FFmpeg。这大大降低了安装的门槛和难度。
3. FFmpeg 的安装选项（Options）
FFmpeg 的功能非常丰富，Homebrew 的 FFmpeg Formula 通常会提供一些“选项”（Options），让用户在安装时选择启用或禁用某些功能或依赖项。例如，您可能可以选择是否启用某个特定的编码器库、硬件加速功能或者滤镜集。
重要变化： 随着 Homebrew Formula 的不断改进和 FFmpeg 本身的演进，许多曾经需要通过 --with-something 或 --enable-something 这样的选项来启用的常用功能，现在已经被默认包含在标准的 FFmpeg 安装中。这意味着对于大多数用户而言，直接运行 brew install ffmpeg 就能获得一个功能齐全的版本，无需指定额外的选项。
如何查看当前的 FFmpeg Formula 提供了哪些选项：
在终端中运行以下命令：
bash
brew info ffmpeg
这个命令会显示关于 Homebrew FFmpeg Formula 的详细信息，包括：
- 当前版本
- 安装路径
- 依赖项列表 (Dependencies)
- 可用选项列表 (Options) – 这个部分列出了您在安装时可以通过
--with-或--without-（较少见）指定的额外功能。
例如，您可能会看到类似 --with-chromaprint (Enable chromaprint audio fingerprinting), --with-fontconfig (Enable fontconfig support), --with-libvmaf (Enable libvmaf support) 等选项。
如果您需要某个非默认启用的功能，您可以在 brew install ffmpeg 命令后面加上相应的选项。例如，如果您想安装带有 chromaprint 支持的 FFmpeg，您可以尝试运行 brew install ffmpeg --with-chromaprint。但请再次强调，先检查 brew info ffmpeg 来确认该选项是否存在且不是默认启用的。
对于绝大多数用户的基础用途（格式转换、简单编辑），直接安装默认版本通常就足够了。
第三部分：执行 FFmpeg 安装步骤
现在，我们已经完成了准备工作并了解了 Homebrew 如何安装 FFmpeg，可以开始实际安装了。
1. 打开终端
确保您已经打开了“终端”应用程序。
2. 更新 Homebrew Formulaes
在安装任何新软件之前，强烈建议您先更新 Homebrew 的 Formulaes 列表。这可以确保 Homebrew 使用最新的可用软件版本和依赖信息。
在终端中输入以下命令并按回车：
bash
brew update
这个命令会联系 Homebrew 的远程仓库，下载最新的 Formulaes 定义。这个过程通常很快。
3. 安装 FFmpeg
现在，执行安装 FFmpeg 的核心命令。
在终端中输入以下命令并按回车：
bash
brew install ffmpeg
如果您需要安装带有特定选项的 FFmpeg（请参考 brew info ffmpeg），则命令会是：
bash
brew install ffmpeg --with-option1 --with-option2 ...
（例如：brew install ffmpeg --with-fontconfig）
安装过程详解：
- Homebrew 会首先检查 FFmpeg 及其依赖项是否已安装。
- 如果发现有未安装的依赖项（例如，
libx264,libmp3lame,libvpx,opus等），Homebrew 会首先开始下载和安装这些依赖项。您会看到终端输出类似Installing dependencies for ffmpeg:后面跟着一长串库名。 - Homebrew 会逐个下载并安装这些依赖项。这个过程可能涉及下载源代码、配置、编译和安装。取决于您的 Mac 性能、网络速度以及需要安装的依赖数量，这可能需要几分钟到几十分钟不等。编译过程会占用一定的 CPU 资源。
- 所有依赖项安装完成后，Homebrew 会下载 FFmpeg 的源代码（或二进制文件）。
- 然后，Homebrew 会根据 Formula 的指示，配置和编译 FFmpeg。这个步骤通常是整个安装过程中最耗时的一部分。您会看到终端输出大量关于配置和编译进度的信息。
- 编译完成后，Homebrew 会安装 FFmpeg 的文件到其 Cellar 目录，并在 Homebrew 的 bin 目录中创建指向
ffmpeg,ffplay,ffprobe等可执行文件的软链接。
终端的输出会详细记录每一步骤，包括下载进度、编译警告/错误（如果发生）、安装路径等。
可能遇到的问题及解决方案：
- 网络问题： 如果下载过程中断，可能是网络不稳定。可以尝试重新运行
brew install ffmpeg。Homebrew 通常能够从中断的地方继续。 - 权限问题：
brew doctor应该能检查出大多数权限问题。确保 Homebrew 的安装目录（/usr/local或/opt/homebrew）及其子目录对于您的用户账号具有写入权限。 Homebrew 官方推荐的安装方式通常会自动处理这些权限。 - 编译错误： 编译错误比较复杂，可能是 Command Line Tools 问题、系统环境问题或特定库的兼容性问题。如果遇到编译错误，终端输出中通常会有详细的错误信息。可以尝试运行
brew doctor检查环境，确保 Command Line Tools 是最新的。如果问题依然存在，可以在 Homebrew 的 GitHub 仓库或相关技术社区寻求帮助，提供详细的错误输出信息。通常，对于常见的 Mac 配置，Homebrew 的 FFmpeg Formula 是相当稳定的。 - 磁盘空间不足： FFmpeg 及其众多依赖项会占用一定的磁盘空间。安装前请确保您的硬盘有足够的可用空间。
请耐心等待安装过程完成。当终端提示安装成功，并且回到了命令提示符时，说明 FFmpeg 已经安装完毕。
第四部分：验证安装
安装完成后，最重要的一步是验证 FFmpeg 是否成功安装并可以在终端中正常运行。
1. 检查 FFmpeg 版本
在终端中输入以下命令并按回车：
bash
ffmpeg -version
如果安装成功，您会看到类似以下的输出：
ffmpeg version 6.0 Copyright (c) 2000-2023 the FFmpeg developers
built with Apple clang version 15.0.0 (clang-1500.0.40.1)
configuration: --prefix=/opt/homebrew/Cellar/ffmpeg/6.0 ... --enable-libx264 --enable-libx265 ... --enable-libmp3lame ... --enable-libvpx ...
libavutil 58. 2.100 / 58. 2.100
libavcodec 60. 3.100 / 60. 3.100
libavformat 60. 3.100 / 60. 3.100
libavdevice 60. 3.100 / 60. 3.100
libavfilter 9. 3.100 / 9. 3.100
libswscale 7. 3.100 / 7. 3.100
libswresample 4.10.100 / 4.10.100
libpostproc 57. 2.100 / 57. 2.100
（注意：版本号和配置信息会根据您安装的具体版本和选项有所不同）
解读输出信息：
ffmpeg version <version_number>: 显示 FFmpeg 的主版本号。built with <compiler>: 显示用于编译 FFmpeg 的编译器（在 macOS 上通常是 Apple Clang）。configuration: ...: 这一行非常重要，它列出了 FFmpeg 在编译时启用的所有配置选项。这行信息会包含--enable-libx264,--enable-libmp3lame,--enable-libvpx等，确认这些库是否被包含，有助于检查您需要的特定功能是否已启用（特别是如果您使用了安装选项）。libavutil,libavcodec,libavformat等: 这些是 FFmpeg 核心库的版本信息。
如果您看到这样的输出，恭喜您，FFmpeg 已经成功安装并可以正常运行了！
如果您看到 command not found: ffmpeg 或者其他错误信息，可能是 Homebrew 的 bin 目录没有正确添加到您的 PATH 环境变量中。请回顾 Homebrew 安装结束时的提示信息，确保您按照指示将相关的行添加到了您的 Shell 配置文件（如 ~/.zshrc 或 ~/.bash_profile）中，然后重新加载配置文件或重启终端。
2. 检查 FFmpeg 可执行文件路径
您可以使用 which 命令来查看系统实际执行的 ffmpeg 命令所在的路径。
bash
which ffmpeg
输出应该类似于 /usr/local/bin/ffmpeg 或 /opt/homebrew/bin/ffmpeg，这表明您正在使用 Homebrew 安装的 FFmpeg 版本。
第五部分：FFmpeg 的基本使用示例
FFmpeg 的功能极其强大且命令选项繁多，深入学习需要查阅官方文档。这里提供几个最基本、最常见的用法示例，帮助您快速入门。
注意： 在使用 FFmpeg 处理文件时，请确保您在终端中位于文件所在的目录，或者在命令中提供文件的完整路径。
1. 查看媒体文件信息
使用 ffprobe 可以查看音视频文件的详细信息，包括容器格式、流信息（视频流、音频流）、编码器、分辨率、帧率、比特率、时长等。
bash
ffprobe /path/to/your/input.mp4
例如：
bash
ffprobe ~/Desktop/myvideo.mov
2. 基本格式转换
将一个 MP4 文件转换为 AVI 文件：
bash
ffmpeg -i input.mp4 output.avi
-i input.mp4: 指定输入文件为input.mp4。output.avi: 指定输出文件为output.avi。
FFmpeg 会尝试根据输出文件的扩展名自动选择合适的编码器和格式。
3. 指定编码器进行格式转换
有时候您需要指定特定的视频和音频编码器。例如，将一个视频文件转换为使用 H.264 视频编码器（libx264）和 AAC 音频编码器（aac）的 MP4 文件：
bash
ffmpeg -i input.mov -c:v libx264 -c:a aac output.mp4
-c:v libx264: 指定视频编码器为libx264。-c:a aac: 指定音频编码器为aac。
4. 提取音频
从一个视频文件中提取音频并保存为 MP3 文件：
bash
ffmpeg -i input.mp4 -vn -acodec libmp3lame output.mp3
-vn: 表示“no video”，即禁用视频流。-acodec libmp3lame: 指定音频编码器为libmp3lame。您也可以简单使用-acodec copy来无损复制原始音频流（如果格式支持）。
5. 从视频中提取图片帧
从视频的某个时间点提取一帧图片：
bash
ffmpeg -i input.mp4 -ss 00:01:00 -vframes 1 output.png
-ss 00:01:00: 跳跃到视频的第 1 分 0 秒处。-ss选项通常放在-i前面以加快定位速度（但精度可能略低），放在-i后面则定位更精确但可能更慢。-vframes 1: 指定只输出 1 个视频帧。output.png: 输出图片文件，格式根据扩展名确定。
6. 压缩视频文件
减小视频文件的大小，通常通过降低视频比特率实现：
bash
ffmpeg -i input.mp4 -b:v 1000k output_compressed.mp4
-b:v 1000k: 设置视频比特率为 1000 kbps。比特率越低，文件越小，但画质可能下降。
7. 添加字幕
将 ASS/SRT 字幕文件“硬烧”（烧录）到视频中：
bash
ffmpeg -i input.mp4 -vf "ass=subtitle.ass" output_with_subtitles.mp4
-vf "ass=subtitle.ass": 使用视频滤镜 (-vf) 的ass或subtitles选项来指定字幕文件路径。需要 FFmpeg 编译时包含fontconfig和libass支持（Homebrew 默认安装通常包含）。
这只是 FFmpeg 功能的冰山一角。FFmpeg 拥有极其丰富的滤镜系统（用于视频和音频处理）、多种多媒体流处理能力、录制功能等。要深入了解，请务必查阅 FFmpeg 的官方文档 (https://ffmpeg.org/documentation.html)。
第六部分：维护与更新 FFmpeg
使用 Homebrew 安装的软件最大的优势之一就是方便的更新管理。
1. 更新 Homebrew Formulaes
在进行任何软件更新之前，总是先更新 Homebrew 的本地 Formulaes 列表：
bash
brew update
这会获取最新的软件版本信息。
2. 更新 FFmpeg
如果您想将 FFmpeg 更新到 Homebrew 中可用的最新版本：
bash
brew upgrade ffmpeg
Homebrew 会检查当前安装的 FFmpeg 版本与 Homebrew 仓库中最新版本之间的差异。如果发现新版本，它会下载、编译并安装新版本，然后自动将旧版本标记为过时。
3. 更新所有 Homebrew 安装的软件
如果您想一次性更新所有通过 Homebrew 安装的软件到最新版本：
bash
brew upgrade
这是一个非常方便的命令，可以保持您的所有命令行工具都是最新的。
4. 清理旧版本和无用文件
Homebrew 在升级软件时会保留旧版本的文件，以便在出现问题时可以方便地回滚。但这些旧版本会占用磁盘空间。您可以使用 brew cleanup 命令来清理这些过时的文件。
bash
brew cleanup
Homebrew 会列出可以清理的项目并提示您确认。这个命令也可以清理一些旧的下载缓存。
使用 brew cleanup -s 可以查看可以节省的空间，而不会实际删除文件。
定期运行 brew update 和 brew upgrade 以及 brew cleanup 是保持 Homebrew 环境整洁和软件最新的好习惯。
第七部分：卸载 FFmpeg
如果您不再需要 FFmpeg，或者想重新安装，可以使用 Homebrew 轻松卸载它。
1. 卸载 FFmpeg 主程序
在终端中输入以下命令：
bash
brew uninstall ffmpeg
Homebrew 会移除 FFmpeg 的文件，并取消 bin 目录中的软链接。
2. 移除不再需要的依赖项
当您卸载 FFmpeg 后，之前为 FFmpeg 安装的许多依赖库可能不再被其他 Homebrew 软件所需要。这些依赖项仍然保留在您的系统中，会占用磁盘空间。您可以使用 brew autoremove 命令来清理这些“孤立”的依赖项。
bash
brew autoremove
Homebrew 会列出它认为可以安全移除的不再被任何已安装软件依赖的库，并提示您确认。
注意： 如果您安装了其他同样依赖 FFmpeg 的软件（例如，一些媒体播放器、编辑器或其他命令行工具，尽管这种情况较少见），brew uninstall ffmpeg 只会卸载 FFmpeg 本身，而不会移除那些仍被其他软件依赖的库。brew autoremove 会智能地只移除完全没有其他软件依赖的库。
第八部分：高级话题与故障排除
1. 使用特定版本
Homebrew 通常只提供软件的最新稳定版本。如果您需要安装特定历史版本的 FFmpeg，这会稍微复杂一些，可能需要通过 Homebrew 的历史提交记录（taps）或者使用 brew versions (一个不再官方支持，但仍可能通过第三方插件使用或手动查看历史 Formula 的方式) 来实现。对于大多数用户，安装最新版本是推荐的做法。
2. 重新安装 FFmpeg
如果您的 FFmpeg 安装似乎有问题，或者您想更改安装选项（例如，最初安装时没有包含某个选项，现在需要），可以使用 brew reinstall 命令：
bash
brew reinstall ffmpeg
或者带选项：
bash
brew reinstall ffmpeg --with-option1 --with-option2 ...
brew reinstall 会先卸载 FFmpeg，然后重新按照 Formula 的定义（包括您指定的选项）进行安装。
3. 检查依赖问题
如果 FFmpeg 运行时出现奇怪的错误，可能是某些依赖库的问题。您可以尝试运行：
bash
brew deps --tree ffmpeg
这个命令会以树状结构显示 FFmpeg 的所有依赖项，帮助您理解其依赖关系。如果某个依赖项有问题，可以尝试单独重新安装该依赖项：brew reinstall <dependency_name>。
再次强调，遇到任何 Homebrew 或安装问题时，先运行 brew doctor，然后根据提示进行修复。
4. FFmpeg 运行时错误
安装成功并能运行 ffmpeg -version 不代表 FFmpeg 在执行所有任务时都不会出错。FFmpeg 运行时遇到的错误通常与输入文件本身、使用的编码器/滤镜参数、系统资源（CPU、内存、磁盘空间）或特定的音视频流特性有关。解决这类问题需要根据 FFmpeg 的错误输出来分析，通常需要查阅 FFmpeg 的官方文档或在线搜索相关的错误信息。
结论
通过本文的详细指南，您应该已经了解了在 macOS 上使用 Homebrew 安装 FFmpeg 的全过程。从准备工作、理解 Homebrew 的机制，到实际的安装、验证、基本使用、更新和维护，我们涵盖了您需要掌握的绝大多数内容。
Homebrew 极大地简化了 FFmpeg 的安装和管理过程，让这个强大的命令行工具变得触手可及。一旦安装成功，您就拥有了一个能够处理几乎所有音视频处理任务的利器。
记住，FFmpeg 的强大在于其灵活多变的命令选项和丰富的滤镜。本文提供的基本示例只是起点。随着您对多媒体处理需求的增加，深入阅读 FFmpeg 的官方文档，学习如何结合不同的选项和滤镜来完成更复杂的任务，将是您进一步提升技能的关键。
祝您在 macOS 上使用 FFmpeg 进行多媒体处理愉快！