yt-dlp 是一款基于 Python 打造的开源命令行工具,堪称当前最先进、最可靠的音视频下载器。它专为应对主流网站(尤其是 YouTube)日益复杂的反爬机制而生,完美继承并大幅超越了已停更的 youtube-dl,能稳定绕过广告、会员墙、地理限制,甚至自动跳过片头片尾——让你一键保存高清视频、无损音频或字幕文件。无论是学习资料、播客、教程还是纪录片,它都能帮你离线带走,不求人、不卡顿、不收费。
核心功能
- 全平台支持:官方支持超 2400 个网站(含 YouTube、Bilibili、Netflix(需配合插件)、Twitch、Instagram、Reddit、BBC、NHK 等),持续更新,中文用户尤其受益于对 Bilibili、腾讯视频、优酷等国内平台的深度适配(部分需配置 Cookie)
- 智能格式选择与批量下载:自动识别最佳画质(如 4K/8K HDR)、最高音质(FLAC/Opus/M4A),支持按分辨率、码率、容器格式精细筛选;一条命令即可下载整期剧集、播放列表或频道全部公开视频
- 原生集成 SponsorBlock:无需额外插件,开箱即用跳过 YouTube 视频中的赞助段落、自我推广、开场动画等干扰内容,观看体验更清爽
- 高度可定制化:支持配置文件(
~/.config/yt-dlp/config)、自定义输出模板、多线程下载、断点续传、代理/Referer/UA 设置,还提供丰富的 JSON/CSV 元数据导出功能,开发者和自动化场景得心应手 - 轻量纯净无广告:纯命令行工具,零图形界面、零后台进程、零数据上传;所有逻辑本地执行,隐私安全有保障
- 活跃维护 & 社区驱动:GitHub 日均提交多次,问题响应极快;Discord 社区超 3 万人,中文用户可获及时帮助;捐赠支持可持续开发,真正由用户推动进化
适合哪些人用
如果你是以下任一角色,yt-dlp 几乎就是为你量身打造:学生党(下载网课、TED 演讲、MOOC 视频离线学习);内容创作者(采集参考素材、备份自己发布的视频、提取高质量音频做剪辑);技术爱好者与极客(写脚本批量处理、集成进 NAS 或 Home Assistant 自动归档);听觉优先用户(一键提取 YouTube 音频转 MP3/FLAC,构建本地播客库);甚至只是普通网民——厌倦了网页端加载慢、广告多、无法下载,想简单快捷地把喜欢的内容“存下来”。它不挑用户,只挑需求是否真实存在。
快速上手
安装极其简单(任选其一):
• macOS/Linux:终端运行 curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && chmod a+rx /usr/local/bin/yt-dlp
• Windows:用 choco install yt-dlp(Chocolatey)或直接下载 exe 文件
• 全平台通用:用 pip 安装——pip3 install yt-dlp
基础使用示例:
• 下载单个高清视频:yt-dlp -f "bestvideo[height<=1080]+bestaudio/best" https://youtu.be/xxx
• 只取音频(MP3 格式):yt-dlp -x --audio-format mp3 https://youtu.be/xxx
• 下载整个 B 站合集:yt-dlp -o "%(title)s.%(ext)s" "https://www.bilibili.com/video/BV1xx411c7mu"
首次使用建议运行 yt-dlp --help 查看完整选项,或访问中文文档站点 yt-dlp.org/zh-Hans 获取详细指南。
项目信息
yt-dlp/yt-dlp
GitHub
A feature-rich command-line audio/video downloader
164.2k
今日 +536 stars today
Stars
13.8k
Forks
Python
Unlicense
编程语言:Python|GitHub Star 数:164,214|开源协议:Unlicense|GitHub 项目地址
它是开源世界里少有的「越用越安心」的工具——不靠订阅盈利,不卖用户数据,只靠热爱与口碑持续进化。


