本文是对开源项目 yt-dlp 的摘要与评论。抓取时仓库约 ★202294、forks≈17709、open issues≈2730；语言 Python，许可证 Unlicense；最新稳定标签 2026.10.21。它是 youtube-dl 的分支，经已停更的 youtube-dlc 一路演进。插图为 GitHub 社交预览图；完整选项与站点列表请看仓库 README 与 Wiki。

合规提醒：下载请遵守目标站点条款与当地法律，只处理你有权保存的内容。下文谈的是工具能力与工程取舍，不是绕过付费墙或侵权教程。

全文主线可以压成一句：在终端里给链接，把音视频（及字幕、元数据、缩略图）按你定的规则落到本地；真正的护城河不是 GUI，而是「跟得上站点改协议」的维护节奏。

这篇在说什么

先讲清使用场景。你可能想归档自己的公开讲座、给 Agent 留一条「给链接出文件」的确定工具、批量拉播客做转写，或者在 CI 里固定拉某条样例素材。这些场景的共同点是：需要可脚本化的下载，而不是再开一个桌面客户端点「保存」。

yt-dlp 支持数千个站点，而不是「只认某一个网站」。和原版 youtube-dl 比，它的卖点不是换个名字，而是持续修提取器（extractor，负责从某站点页面解析出真实媒体地址的模块）+ 一批默认更「现代」的行为——分辨率/编码优先、更强的 YouTube 路径、SponsorBlock、并行分片等。

为什么命令行下载器仍在变重要

桌面下载器与在线「粘贴链接即下」服务一直存在，但 Agent 与自动化流水线更需要的是：无界面、可脚本、可钉版本、失败时可观察退出码 的工具。yt-dlp 恰好落在这个位置。站点改协议时，社区修提取器的速度，直接决定你的归档脚本今晚还能不能跑；这一点，星标数字解释不了，changelog 才能解释。

另一个常被低估的点是「后处理默认路径」：合并音视频、切 SponsorBlock 段落、按章节拆分、写出元数据——这些若每次靠人手点 GUI，很难进 CI 或 Agent 工具表。CLI 把它们收成可组合开关，代价是选项多；收益是一次写对配置，之后重复使用。

相对 youtube-dl，多了什么值得记

官方 CHANGES FROM YOUTUBE-DL 很长，实务上常碰到的几块可以先记这些：

1. SponsorBlock：可按类别给章节打标，或直接切掉赞助/片头等段落（走 SponsorBlock 的众包 API）。下载时一次做完，播放时就不用再装插件跳广告段。
2. 格式排序 -S：默认更偏向更高分辨率与更好编码，而不是「谁码率大谁赢」；比堆一长串 -f 格式串好记。
3. YouTube 相关：Clips / Stories、搜索前缀、部分 Feeds、直播 --live-from-start（实验）、频道 URL 拉全量上传（含 Shorts/Live）等。
4. 浏览器 Cookie：--cookies-from-browser 从主流浏览器导出会话（登录态内容要自己掂量风险与合规）。
5. 按时间/章节裁剪与拆分：--download-sections、--split-chapters。
6. 并行分片：-N / --concurrent-fragments 加速 m3u8/mpd 一类流式清单。
7. 可移植配置、输出模板增强、插件（提取器/后处理）、yt-dlp -U 自更新、nightly/master 通道。
8. 可嵌入：import yt_dlp 给脚本或服务用（官方有 Embedding 一节）。

默认行为也和 youtube-dl 有意不同：例如当前只支持 Python 3.11+；默认输出模板、bv*+ba/b 格式选择、默认不因单条错误中止等——需要旧习惯时可查 --compat-options。

解读：youtube-dl upstream 更新慢时，站点一改签名或媒体清单，工具就「集体罢工」。yt-dlp 把「跟得上提取器」做成社区主战场；你换的不是界面皮肤，是维护节奏。选型时星标数字不如 changelog 是否在动。

日常怎么装、怎么用（极简）

安装见官方 Installation Wiki：独立二进制、pip、各发行版包管理器均可。强烈建议本机有 ffmpeg（一套音视频转封装与合并工具）——合并分开下载的音轨视频轨、转封装、不少后处理都靠它。

# 更新到最新稳定
yt-dlp -U

# 最常见：给 URL，默认挑较好的视频+音频并合并
yt-dlp "https://example.com/watch?v=…"

# 只看有哪些格式
yt-dlp -F "URL"

# 按分辨率偏好排序后下载（示例）
yt-dlp -S "res:1080,ext" "URL"

配置文件可放在用户目录等位置（见 README CONFIGURATION），把常用 --paths、输出模板、代理写成默认，避免每次敲一长串。入门不必一次吃完整本手册：先会用 -F 看格式、-S 定偏好、输出模板定文件名，就够覆盖大部分日常。

解读：CLI 的护城河是可脚本化——归档频道、批量播客、CI 里拉样例素材、给 Agent 留一个「给链接出文件」的确定工具。选项爆炸是代价；护城河换来的是确定性输出，而不是「看起来下完了其实缺音轨」。

和周边生态的关系

• SponsorBlock：把「跳广告段」从播放器插件变成下载时一次做完。
• 插件：外部提取器/后处理可覆盖或扩展内置逻辑，站点特例不必等上游合入。
• 嵌入 API：比自己再写一个爬虫稳——站点适配仍由上游维护，你的服务只消费稳定接口。

在本站上下文里，它也常出现在「从 X / YouTube 拉公开视频再做转写解读」一类流水线里：职责清晰——只负责拿到媒体与元数据，理解内容交给别的步骤。上层工具（选题 Agent、译制后台、本地 ASR）可以换，下载底座不必每换一层就重写。

给 Agent / 流水线用时要注意什么

本站一类「公开视频 → 转写 → 解读」流水线，通常只把 yt-dlp 当成确定的取文件工具：输入 URL，输出本地媒体与元数据；理解内容交给 ASR 与写作步骤。这样拆的好处是：站点改版时，你主要跟 yt-dlp 的提取器更新，而不是重写整条流水线。

实务上还有几条容易忽略的边界：

• 更新节奏：稳定版用 yt-dlp -U；个别站点临时坏了，可临时切 nightly，但生产脚本应钉版本并读 changelog。
• 输出确定性：输出模板、--paths、是否写描述文件与缩略图，应写进配置，避免 Agent 每次临场拼参数导致路径漂移。
• 失败语义：默认不因播放列表里单条错误中止，对批量归档友好，但对「必须全成功」的 CI 要显式收紧错误策略。
• 登录态：--cookies-from-browser 能拿到更多内容，也把浏览器会话暴露给下载进程——只应用于你有权访问的账号与内容，并注意机器共享场景。

解读：把 yt-dlp 当「基础设施」而不是「临时命令」时，配置与版本钉扎比背更多选项开关更重要。Agent 侧只需稳定契约：给链接、拿文件、报告退出码。

若你把它嵌进自己的服务，优先走官方 Embedding API，并订阅上游安全与破坏性变更说明：提取器行为变化有时会改变默认格式选择或文件名模板，CI 里应用黄金样例做回归，而不是假设「去年能下的链接今年输出字节级一致」。

对个人归档场景，先从「单条 URL + 固定输出模板 + ffmpeg 已安装」三条检查清单过一遍，再考虑播放列表、直播与 Cookie；把简单路径跑稳，比一上来堆并行分片与插件更不容易挫败。

Wiki 的 Installation 与站点列表会随版本更新，遇到陌生站点时先查 supportedsites 与近期 issue，再决定是换参数还是等提取器修复。

合规边界始终高于工具能力：能下载，绝不等于应当下载。

怎么看

yt-dlp 不是新概念，但在「网站反爬/改协议」的军备竞赛里，活着的分支本身就是产品。选型时盯三件事：

1. 你要的站点是否在 supportedsites，且近期 changelog 有动；
2. 本机 ffmpeg 是否齐，输出模板是否写进配置；
3. 自己的合规边界——工具能下，不等于你有权存。

完整参数、提取器参数与贡献指南以仓库为准；社区讨论见官方 Discord（仓库 homepage）。