安装配置

yt-dlp 有两种使用方式：命令行可执行文件（CLI）和 Python 包。选择适合你的方式开始安装。

前置依赖：无论哪种方式，都强烈建议安装 FFmpeg，用于视频格式转换和音频提取。参见 FFmpeg 安装指南。

CLI 可执行文件安装

# 方式一：winget（推荐）
winget install yt-dlp

# 方式二：scoop
scoop install yt-dlp

# 方式三：pip
pip install yt-dlp

# 方式四：直接下载
# 从 https://github.com/yt-dlp/yt-dlp/releases 下载 yt-dlp.exe
# 放到 PATH 环境变量中的某个目录即可

# 方式一：Homebrew（推荐）
brew install yt-dlp

# 方式二：pip
pip install yt-dlp

# 方式一：包管理器
# Ubuntu/Debian
sudo apt install yt-dlp
# Arch Linux
sudo pacman -S yt-dlp

# 方式二：pip（推荐，版本更新）
pip install yt-dlp

验证安装

yt-dlp --version

验证输出

$ yt-dlp --version
2026.03.03

Python 包安装

pip install yt-dlp

验证 Python 包

import yt_dlp
print(yt_dlp.version.__version__)

Python 验证

>>> import yt_dlp
>>> print(yt_dlp.version.__version__)
2026.03.03

FFmpeg 安装

yt-dlp 的许多功能（音频提取、格式合并、字幕嵌入等）依赖 FFmpeg。不安装 FFmpeg 将导致部分功能不可用。

# winget
winget install Gyan.FFmpeg

# scoop
scoop install ffmpeg

# 或手动下载：https://www.gyan.dev/ffmpeg/builds/
# 解压后将 bin 目录添加到 PATH

brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

# Arch Linux
sudo pacman -S ffmpeg

验证 FFmpeg

ffmpeg -version
ffprobe -version

更新 yt-dlp

# 更新到最新版本
yt-dlp -U

# 或通过 pip 更新
pip install -U yt-dlp

# 通过 pip 更新
# pip install -U yt-dlp

# 在代码中检查版本
import yt_dlp
print(f"当前版本: {yt_dlp.version.__version__}")

更新输出

$ yt-dlp -U
Current version: 2026.03.03
yt-dlp is up to date (2026.03.03)

下一步

安装完成后，前往第一次下载开始你的第一次视频下载！

安装配置

On this page