yt-dlp 是一款基于 yt-dlc 分支、脱胎于 youtube-dl 的命令行视频 / 音频下载工具,主打对各类流媒体平台的下载支持,且在原项目基础上做了大量功能增强、bug 修复和特性迭代,是目前最活跃的 youtube-dl 衍生项目之一。
专为下载网络视频 / 音频设计,支持数百个主流 / 小众流媒体平台,核心优势是更新及时、兼容性强、功能丰富,适用于 Windows、macOS、Linux 等多系统。
支持多种安装途径,最常用的方式:
直接下载可执行文件从项目 Releases 页面(https://github.com/yt-dlp/yt-dlp/releases)下载对应系统的二进制文件(如 Windows 的 yt-dlp.exe、Linux 的 yt-dlp),添加到系统 PATH 即可。
包管理器安装
pip install yt-dlp(或通过 distro 专属包管理器如 apt、dnf);brew install yt-dlp;winget install yt-dlp 或 pip install yt-dlp。源码安装
git clone https://github.com/yt-dlp/yt-dlp.git
cd yt-dlp
python -m pip install -U .基础使用示例
# 下载单个视频(自动选最佳画质)
yt-dlp https://www.youtube.com/watch?v=xxxx
# 下载视频并指定格式(如仅音频,输出为 mp3)
yt-dlp -x --audio-format mp3 https://www.youtube.com/watch?v=xxxx
# 下载播放列表,仅下载前5个视频
yt-dlp --playlist-items 1-5 https://www.youtube.com/playlist?list=xxxx
# 自定义输出文件名(标题+上传者+分辨率)
yt-dlp -o "%(title)s_%(uploader)s_%(resolution)s.%(ext)s" https://www.youtube.com/watch?v=xxxx
# 下载字幕(自动嵌入或单独保存)
yt-dlp --write-sub --sub-lang zh,en https://www.youtube.com/watch?v=xxxx:基于 Unlicense 许可证(宽松开源协议),无商业限制;
社区活跃:核心维护团队响应快,社区贡献者多,bug 修复和平台适配迭代频繁;
yt-dlp -U)。如果需要更细分的功能(如特定平台的下载技巧、高级参数配置),可参考项目官方文档:https://github.com/yt-dlp/yt-dlp