yt-dlp：120K+ Stars 的开源音视频下载神器

一、这是什么？

yt-dlp 是基于 Python 的开源命令行音视频下载工具，是已经停更的 youtube-dl 的活跃分支（fork）。

简单来说：你在 B 站、YouTube、Twitter、TikTok、抖音等任何视频网站看到一个视频，想下载到本地永久保存——yt-dlp 复制粘贴链接就能下。

二、它解决什么痛点？

日常下载视频有这几个老问题：

1. 网页右键另存为只能下到 m3u8/分片，合并不了
2. 需要特定分辨率或仅音频，网页端不提供选择
3. 批量下载播放列表，网页一个一个点太慢
4. 下载被中断要从头开始，网络环境差的情况
5. 广告平台加水印，需要原始清晰度
6. 想看视频但不想登录网站，要个本地播放器就能看

三、核心功能模块

1. 格式与质量选择

2. 字幕与元数据

• 多语言字幕下载——--sub-langs all 一键全下
• 自动翻译字幕——YouTube 自动字幕全语言提取
• 元数据嵌入——标题、作者、日期、描述写入文件
• SponsorBlock——自动跳过广告/赞助片段

3. 批量与自动化

4. 高级能力

• Cookie 认证——绕过 YouTube 登录限制
• 代理支持——HTTP/SOCKS5
• 章节切割——按视频章节切成多个文件
• 直播录制——从开头录制直播流
• 限速下载——--limit-rate 5M

四、技术架构

五、怎么安装？

方式一：单文件二进制（推荐）

# macOS
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp_macos -o /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlp

# Linux
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlp

方式二：pip

pip install -U yt-dlp

方式三：Homebrew

brew install yt-dlp
brew install ffmpeg  # 必备依赖

brew install ffmpeg        # macOS
sudo apt install ffmpeg    # Linux
choco install ffmpeg        # Windows

六、5 分钟上手

1. 基础下载（最佳质量）

   yt-dlp -P ~/Downloads/yt-dlp "VIDEO_URL"

2. YouTube 带 Cookie（避坑）
   YouTube 现在会屏蔽未认证请求，必须带浏览器 Cookie：

   yt-dlp --cookies-from-browser chrome "VIDEO_URL"

3. 只下音频（提取 MP3）

   yt-dlp -x --audio-format mp3 "VIDEO_URL"

4. 下载字幕

   yt-dlp --write-subs --sub-langs zh-Hans,en "VIDEO_URL"

5. 指定分辨率

   # 720P
   yt-dlp -f "bestvideo[height<=720]+bestaudio/best[height<=720]" "VIDEO_URL"
   # 1080P
   yt-dlp -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" "VIDEO_URL"
   # 4K 优先
   yt-dlp -f "bestvideo[height>=2160]+bestaudio/best" "VIDEO_URL"

6. 下载播放列表

   # 整张播放列表
   yt-dlp -o "%(playlist)s/%(playlist_index)02d - %(title)s.%(ext)s" "PLAYLIST_URL"
   # 只下前 5 集
   yt-dlp -I 1:5 "PLAYLIST_URL"

7. 下载前查看可用格式

   yt-dlp -F "VIDEO_URL"

七、进阶玩法

并发分片下载（速度翻倍）

yt-dlp -N 8 "VIDEO_URL"

智能格式选择

yt-dlp -S "res:1080,ext:mp4:m4a" "VIDEO_URL"

按章节切片

yt-dlp --split-chapters -o "chapter:%(title)s/%(section_title)s.%(ext)s" "VIDEO_URL"

自动跳过广告（SponsorBlock）

yt-dlp --sponsorblock-remove sponsor "VIDEO_URL"
yt-dlp --sponsorblock-remove all "VIDEO_URL"  # 移除所有非必要片段

录制直播

yt-dlp --live-from-start "LIVE_STREAM_URL"

限速下载

yt-dlp --limit-rate 5M "VIDEO_URL"

八、谁在用？

图形界面包装（给非程序员用）

九、横向对比

结论：命令行用户首选 yt-dlp，没有之一；普通用户选 Stacher（macOS）/ yt-dlg（Windows）。

十、近期更新

节奏：几乎是周级更新，安全性问题响应极快。

十一、避坑指南

十二、安全提醒

新版修复了 3 个重要 CVE，建议立即升级：

yt-dlp --update
# 或
pip install -U yt-dlp

十三、配置文件

把常用选项放到 ~/.config/yt-dlp/config：

# ~/.config/yt-dlp/config
--no-mtime
--write-subs
--sub-langs zh-Hans,en
--embed-metadata
--embed-thumbnail
--cookies-from-browser chrome
-P ~/Downloads/yt-dlp
-o "%(uploader)s/%(upload_date>%Y-%m-%d)s - %(title)s.%(ext)s"

配置后直接 yt-dlp "URL" 即可。

十四、与 youtube-dl 的关系

十五、总结