yt-dlp：功能丰富的命令行音视频下载器｜部署与使用全指南

项目仓库： https://github.com/yt-dlp/yt-dlp

许可证：Unlicense（公共领域） · 形态：Python CLI 工具 · 支持站点：数千个 · 前身：youtube-dl / youtube-dlc

1 项目简介

yt-dlp 是功能丰富的命令行音视频下载器，支持数千个站点。它是 youtube-dl 的活跃 fork，基于已停止维护的 youtube-dlc。在 youtube-dl 原作者停止维护期间，由社区接管并持续快速迭代。

1.1 核心信息一览

1.2 适用场景

• 下载 YouTube/B 站等数千站点视频。
• 仅提取音频。
• 批处理、脚本化下载。

2 功能特性

• 数千站点：YouTube、B 站、Twitter 等。
• 格式选择：-f 指定画质。
• 仅音频：-x --audio-format mp3。
• 字幕：自动下载。
• SponsorBlock：自动跳过赞助片段。
• 配置文件：yt-dlp.conf。
• 插件系统：扩展提取器。
• netrc 认证。

3 官方跳转链接汇总

4 前置要求

• Python 3.9+。
• ffmpeg（合并音视频/转码）。

5 方式一：pip 安装

python3 -m pip install -U yt-dlp

6 方式二：独立二进制

从 GitHub Releases 下载对应平台二进制。

7 常用命令

# 最佳画质
yt-dlp "https://www.youtube.com/watch?v=..."

# 仅音频
yt-dlp -x --audio-format mp3 "URL"

# 指定格式
yt-dlp -f "bv*+ba/b" "URL"

# 字幕
yt-dlp --write-subs --sub-langs "zh.*" "URL"

8 配置文件

在 yt-dlp.conf 中写默认参数；netrc 管理登录态。

9 常见故障排查

• 视频下载失败：升级 yt-dlp（站点变化频繁）。
• 合并失败：装 ffmpeg。
• 地区限制：用 --geo-bypass 或代理。

10 风险与合规说明

• Unlicense 公共领域。
• 仅下载你有权下载的内容；遵守各站点服务条款与版权法。

本文基于官方 README 整理，仅供学习与部署参考；以仓库最新说明为准。