yt-dlp - 功能丰富的命令行音视频下载器
yt-dlp 是一款功能丰富的命令行音频/视频下载器，支持数千个网站，是 youtube-dl 的分支，基于已停止维护的 youtube-dlc。提供多种安装方式、灵活的下载选项、格式选择、字幕支持、后处理等，并持续更新以适配网站变化。
社区作者 · Aitroys 管理员
它解决什么问题
yt-dlp 是一个功能丰富的命令行音频/视频下载器，支持数千个网站。项目是 youtube-dl 的分支，基于现已停止维护的 youtube-dlc。它提供了大量可配置选项，涵盖网络、地理限制、视频选择、下载、文件系统、缩略图、字幕、认证、后处理、SponsorBlock、提取器选项等。支持多种安装方式，包括预编译二进制、pip 以及第三方包管理器。项目许可证为 Unlicense，但部分发布文件包含其他许可证（如 GPLv3+）。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
一、安装准备
步骤 1 · 推荐使用预编译二进制或
pip 安装。
- 系统需安装 Python 3.10+（CPython）或 3.11+（PyPy），其他版本可能无法正常工作。
- 强烈推荐安装 ffmpeg 和 ffprobe，用于合并音视频文件及后处理。
二、安装方式
【方式 A：使用预编译二进制】 从 GitHub Releases 下载对应平台的二进制文件（如 Windows 使用 yt-dlp.exe，macOS 使用 yt-dlp_macos，Linux 使用 yt-dlp_linux 等），放入 PATH 目录或直接运行。 示例：
curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o yt-dlpchmod +x yt-dlpsudo mv yt-dlp /usr/local/bin/
【方式 B：使用 pip 安装】 运行以下命令安装（包含默认推荐依赖）：
python -m pip install -U "yt-dlp[default]"若需安装 nightly 版本：
python -m pip install -U --pre "yt-dlp[default]"【方式 C：第三方包管理器】 参考项目 Wiki 或相应包管理器文档。
三、更新
使用发行版二进制时，运行 yt-dlp -U 自动更新至当前频道最新版。 切换更新频道： yt-dlp --update-to nightly # 切换到 nightly 并更新 yt-dlp --update-to stable@2023.07.06 # 切换到 stable 频道指定标签
pip 安装的可重新运行原安装命令。四、首次使用
直接运行 yt-dlp [OPTIONS] URL 即可开始下载。例如： yt-dlp https://www.youtube.com/watch?v=example
五、常见问题
- 若遇到缺失依赖，yt-dlp 会给出警告，可根据提示安装相应依赖。
- 执行 --verbose 可查看当前可用依赖列表。
- 更多 FAQ 和详细说明请参考项目 Wiki。
来源教程配图
