
yt-dlp 的 GitHub 仓库首页,2026-11 截图
一句话定位与基本信息
yt-dlp 是一个功能丰富的命令行音视频下载器,官方 README 的口径是支持数千个站点(其支持站点清单 supportedsites.md 逐年变长)。它从已基本停更的 youtube-dl 分叉而来,在原有提取器体系上持续加入新功能与站点修复,是目前这一品类里维护最活跃的开源项目。项目没有独立官网,GitHub 仓库就是它的官方主页与发布渠道。仓库创建于 2020 年 10 月,截至 2026 年 11 月快照,星标约 20.7 万、Fork 约 1.8 万,是 GitHub 上关注度最高的下载类工具之一。yt-dlp 以 Python 编写,采用 Unlicense 协议(等同于公有领域式授权),发布形式包括 pip 包与各平台的独立可执行文件,Windows、macOS、Linux 均可运行。它本身只有命令行界面,图形前端均为社区第三方项目。文档以英文为主。
平台背景
理解 yt-dlp 要从 youtube-dl 说起:后者曾是统治级的开源视频下载器,但 2020 年前后因法律事件与维护节奏问题逐渐停滞,其活跃分支 youtube-dlc 试图接棒也未能持续。yt-dlp 正是在这个节点上从 youtube-dlc 分叉(README 原文称其为基于已不活跃的 youtube-dlc 的 youtube-dl 分叉),策略是「保持兼容、大步加功能」:命令行参数大体延续 youtube-dl 的习惯,同时加入 SponsorBlock、更强的格式选择、更快的更新节奏等改进。此后它逐渐成为事实上的继任者:各大 Linux 发行版、包管理器与无数教程都切换到了 yt-dlp。它的维护模式高度依赖社区——上千个站点的提取器靠全球贡献者随站点改版不断修补,官方还设有 nightly 预发布构建通道,让急需修复的用户先用上最新提取器。这种「与站点改版赛跑」的节奏,也是它保持可用的核心代价。
核心服务与功能

yt-dlp 官方支持站点清单(supportedsites.md),2026-11 核查
第一是覆盖面:支持站点清单包含数千个条目,从主流视频平台、流媒体、播客到各国电视台站点,绝大多数公开视频页面都能尝试提取。第二是画质与格式控制:可以按分辨率、编码、帧率精确筛选格式,音视频分离的流能自动调用 FFmpeg 合并,也能只提取音频并转码为指定格式。第三是字幕与元数据:可下载、嵌入多语言字幕(含自动生成字幕),把标题、缩略图、简介等元数据写入文件,方便归档整理。第四是 SponsorBlock 集成:能把赞助、片头等片段标记为章节,或直接剪除,这是相对 youtube-dl 最有代表性的新增能力之一。第五是批量与自动化:支持播放列表、频道与用户主页的批量枚举下载,配合输出文件名模板、下载存档文件(避免重复下载)、断点续传、限速与代理设置,很适合写成脚本长期跑。此外它还支持用浏览器 cookies 访问需要登录才能观看的内容、按章节切分、直播流录制等进阶用法,参数体系庞大,README 与 Wiki 是主要说明书。
使用方式
安装有三条常见路径:从 GitHub Releases 下载对应平台的独立可执行文件(Windows 为 yt-dlp.exe,免装 Python);或用 pip install yt-dlp 安装;或通过 winget、Homebrew、发行版仓库等包管理器安装。想要最佳合并与转码能力,建议同时安装 FFmpeg 并加入 PATH。基本用法只有一行:yt-dlp 视频链接,即按默认策略抓取可用的最佳画质;常用组合包括 -F 先列出全部格式再挑选、-x 只提音频、–write-subs 带字幕、-a 批量清单文件等。由于站点经常改版,遇到提取失败先升级到最新版(自带 -U 自更新,独立版适用)往往就能解决;追新功能与紧急修复的用户可以改用官方 nightly 构建。没有图形界面是它明确的取舍,需要点选操作的用户只能叠加第三方 GUI,那已不属于官方维护范围。
适用人群
最适合的是有离线归档需求的用户:把公开课、演讲、自己投稿的视频、播客节目批量保存到本地或 NAS,按模板命名归档。其次是内容创作者与研究人员,需要合规地采集公开素材、字幕文本做分析或二次创作的准备工作。再就是自动化用户,把 yt-dlp 写进脚本做订阅式追更下载。不太适合的是只想偶尔存一两个短视频、且完全不愿碰命令行的用户——在线下载网站或浏览器扩展的上手成本低得多(但稳定性和隐私另当别论);也不适合期望「装好就永远能用」的人,站点改版决定了它需要定期更新。另外要提醒:它常被与盗版下载联系在一起,工具本身是中立的,能否下载、下载后能否使用,取决于内容授权与所在地法律,见文末风险部分。
免费与付费

yt-dlp 的 GitHub 发布页(Releases),2026-11 核查
yt-dlp 完全免费:Unlicense 协议开源,正式版与 nightly 构建都通过 GitHub Releases 与 PyPI 免费分发,没有付费版、没有会员、没有功能解锁(2026-11 核查)。它的成本不在软件本身,而在使用环境:一台能运行它的电脑或服务器、足够的存储空间,以及访问目标站点所需的正常网络条件。项目接受社区捐赠以支持维护,自愿性质。市面上任何自称「yt-dlp 付费版、高速版」的网站或软件都不是官方版本,谨防捆绑与恶意软件;认准 GitHub 仓库与 PyPI 两个官方渠道即可。
优点与缺点
优点:第一,站点覆盖与更新速度是同类最佳梯队,数千站点的提取器由活跃社区持续修补,正式版之外还有 nightly 通道兜底;第二,功能深度出色,格式筛选、字幕、SponsorBlock、元数据与批处理构成完整的归档工作流,不是「能下」而已,而是「下得可控」;第三,跨平台且分发方式多,单文件版零依赖即可跑,老机器与服务器都适用;第四,开源透明、协议宽松(Unlicense),被无数其他工具与脚本集成,生态稳固。缺点:第一,纯命令行,参数多达数百个,新手从「最佳画质加字幕」这类常见需求也要查文档拼参数;第二,可用性随目标站点政策波动,平台加强验证或限制时会出现阶段性失效,只能等更新跟进;第三,下载高画质与合并转码依赖 FFmpeg 等外部组件,环境没配齐时容易踩坑;第四,官方文档只有英文,且 README 体量巨大,检索成本不低。
同类竞品对比
站内与 yt-dlp 经常被放在同一工具箱的条目如下,分工差异大于竞争关系:
| 工具 | 定位 | 费用模式 | 运行平台 | 中文支持 |
|---|---|---|---|---|
| yt-dlp | 命令行音视频下载器,支持数千站点 | 完全免费开源 | Windows / macOS / Linux | 文档英文 |
| Rclone | 云存储文件同步工具 | 完全免费开源(MIT) | Windows / macOS / Linux | 官方文档英文 |
| Cobalt | 网页端媒体保存工具,粘贴链接即下载 | 免费开源,可自托管 | Web | 英文界面 |
| Clash Verge Rev | 代理客户端(图形界面) | 免费开源 | Windows / macOS / Linux | 有中文界面 |
选择逻辑很清楚:要批量、可脚本化地下载与归档,用 yt-dlp;只想临时存一个链接、不想装任何东西,用 Cobalt 这类网页工具;下载完的文件要同步进云存储,接 Rclone;访问某些站点需要代理时,Clash Verge Rev 负责网络层。
注意事项与风险
第一,版权与平台条款:yt-dlp 只是下载工具,下载受版权保护的内容并传播、商用可能侵权,许多平台的服务条款也禁止站外下载;请只用于个人学习、已获授权或公有领域内容,并遵守所在地法律。第二,账号风险:使用 cookies 下载需要登录的内容时,等于把账号会话交给了脚本,高频或异常的请求可能触发平台风控,重要账号谨慎使用。第三,来源安全:只从 GitHub 官方仓库与 PyPI 获取程序,第三方「整合包」常有捆绑。第四,隐私与合规:批量采集时注意目标站点的 robots 与频率礼仪,不要把公共服务打挂。第五,版本纪律:遇到大面积失效先更新再排障,这是使用这类工具的基本功。
![yt-dlp音视频下载神器的使用截图[1]](https://ytm.app/wp-content/uploads/2024/11/1732198974-yt-dlp1121.jpg)