FFmpeg 安装

FFmpeg 是 yt-dlp 的关键依赖，用于：

音频提取与转换
视频格式合并
缩略图嵌入
字幕嵌入
视频转码

不安装 FFmpeg，yt-dlp 的很多核心功能将不可用（如 -x 提取音频、合并分离的视频和音频流等）。

安装

方式一：winget（推荐）

winget install Gyan.FFmpeg

方式二：scoop

scoop install ffmpeg

方式三：Chocolatey

choco install ffmpeg

方式四：手动安装

下载：前往 gyan.dev/ffmpeg/builds
下载 ffmpeg-release-essentials.zip（精简版）或 ffmpeg-release-full.zip（完整版）
解压到如 C:\ffmpeg\
将 C:\ffmpeg\bin 添加到系统 PATH 环境变量
重新打开终端验证

Homebrew

brew install ffmpeg

Ubuntu/Debian

sudo apt update
sudo apt install ffmpeg

Arch Linux

sudo pacman -S ffmpeg

Fedora

sudo dnf install ffmpeg

从源码编译

# 获取最新版本
git clone https://git.ffmpeg.org/ffmpeg.git
cd ffmpeg
./configure --enable-gpl --enable-nonfree
make -j$(nproc)
sudo make install

验证安装

ffmpeg -version
ffprobe -version

验证输出

$ ffmpeg -version
ffmpeg version 7.1 Copyright (c) 2000-2024 the FFmpeg developers
built with gcc 14.2.0

$ ffprobe -version
ffprobe version 7.1 Copyright (c) 2007-2024 the FFmpeg developers

常见问题

"ffmpeg not found" 但已安装

Windows：确保 ffmpeg.exe 所在目录已添加到 PATH
验证：where ffmpeg（Windows）或 which ffmpeg（macOS/Linux）
重启终端后再试

FFmpeg 与 yt-dlp 放在一起

yt-dlp 会搜索以下位置的 FFmpeg：

系统 PATH 中
yt-dlp 同一目录下
环境变量 FFMPEG_LOCATION 指定的路径

# 手动指定 FFmpeg 路径
yt-dlp --ffmpeg-location /path/to/ffmpeg "URL"

最低版本要求

yt-dlp 推荐 FFmpeg >= 5.0。部分功能（如 SponsorBlock 分段处理）需要更新版本。

# 查看版本
ffmpeg -version | head -1

FFmpeg 安装

On this page