没有绝望的处境，只有对处境绝望的人。——哈尔西
yt-dlp：功能最强大的命令行视频/音频下载神器
在互联网内容爆发的今天，“保存”与“离线”依旧是刚需。无论你是视频发烧友、音频收集癖，还是开发者、数据分析师，只要你想批量下载和管理来自 YouTube、Bilibili、Twitter 等主流平台的音视频内容，yt-dlp 都是你的不二之选！
一、项目简介
- 项目地址：yt-dlp/yt-dlp
- 一句话描述：A feature-rich command-line audio/video downloader
- 主要语言：Python
- Stars：128,467+
- Forks：10,292+
- 标签：
clidownloaderyoutube-downloadersponsorblockpython - 开源协议：The Unlicense
- 官网/社区：Discord
二、yt-dlp 能做什么？
1. 支持超多主流网站
- 内置数百个网站适配器，主流视频网站（如 YouTube、Bilibili、Twitter、TikTok、SoundCloud、Twitch、Vimeo、Facebook、Instagram、微博、AcFun……）全部“一网打尽”。
- 支持下载单个视频、整个频道/播放列表，甚至付费内容（取决于你有账号/权限）。
2. 功能极致丰富
- 自定义音视频格式：可指定分辨率、码率、封装格式（mp4、mkv、webm、mp3、flac等）。
- 自动合并音视频流：YouTube 提供的 1080p+ 通常是分开的，yt-dlp 自动合并。
- 批量下载/去重/断点续传：支持大批量下载，断点续传无压力。
- SponsorBlock 自动跳广告段：可自动跳过视频片头、广告、彩蛋等 SponsorBlock 支持的片段。
- 多线程下载：大幅提升下载速度。
- 字幕/弹幕/元数据抓取：支持下载并合并原生字幕、弹幕、评论、视频描述、作者信息等。
3. 强大的命令行体验
- 参数极其细致，适合自动化脚本、批处理、爬虫等场景。
- 丰富的输出模板，支持自定义文件名、目录结构、日志格式。
三、快速上手
1. 安装
推荐 pip 安装：
1 | |
或者直接下载官方发行版二进制：
1 | |
2. 基本用法
下载单个视频：
1 | |
只下载音频并转为 mp3：
1 | |
下载整个播放列表：
1 | |
指定分辨率和格式：
1 | |
自动跳过 SponsorBlock 片段：
1 | |
断点续传+多线程：
1 | |
四、进阶玩法
- 批量下载：把链接存进文本文件，
yt-dlp -a urls.txt - 自动字幕下载：
yt-dlp --write-subs --sub-lang zh,en ... - 仅抓取元数据不下载：
yt-dlp --skip-download --print-json ... - 配合 aria2c 等多线程工具：
yt-dlp --external-downloader aria2c ... - 丰富的 hooks/自定义脚本，集成到自动化流程
五、和 youtube-dl 有什么不同？
yt-dlp 是 youtube-dl 的硬分叉（hard fork），拥有更快的更新、更强的功能、更好的社区活跃度。大量新特性（如 SponsorBlock、格式筛选、性能优化等）都只有 yt-dlp 支持。
六、开源社区与生态
- 2K+ Issues，持续活跃开发
- Wiki：官方教程、参数详解、平台适配说明
- Discord 社区：实时交流、技术支持
七、总结
yt-dlp 是目前开源世界中最强大、最好用的音视频下载利器，适合个人收藏、批量归档、数据分析、二次开发等多种场景。无论你是初学者还是资深极客，都能在 yt-dlp 找到自己的生产力神器。
官方地址：https://github.com/yt-dlp/yt-dlp
快来试试吧，做你自己的“互联网归档官”！