yt-dlp 下载速度很慢怎么办？

可尝试并发下载 yt-dlp -N 8、断点续传 yt-dlp -c、使用 aria2c 外部下载器 --external-downloader aria2c，或检查网络与代理设置。

yt-dlp 使用教程：三步快速上手 + 常用命令速查

Q: 某个网站下载失败怎么办？

网站改版会导致提取器失效。请先执行 yt-dlp -U 更新到最新版本；若仍失败可到 GitHub Issues 反馈，并提供 --verbose 完整报错日志。

Q: 需要登录的网站如何下载？

可使用 --cookies-from-browser 读取浏览器 Cookie，或 --cookies cookies.txt 指定文件；部分站点支持 -u/-p 账号密码参数。请仅下载你有权访问的内容。

Q: 如何验证下载文件的完整性？

官方每个发行版均提供 SHA2-256/SHA2-512 校验和与 GPG 签名（SHA2-256SUMS.sig 等）。使用仓库中的公钥 public.key 验签，确保文件完整且来自官方。

Quick Start

三步快速上手

安装完成后，只需三步即可完成第一次下载。

1

验证安装

打开终端，输入以下命令确认安装成功：

yt-dlp --version

2

复制链接

在任意支持平台的视频页面复制网址：

https://…/watch?v=…

3

执行下载

运行命令，文件将保存在当前目录：

yt-dlp "视频链接"

Common Commands

常用命令速查

以下命令覆盖绝大多数日常场景，点击「复制」即可使用。

下载单个视频

默认获取最佳画质并自动合并音视频。

$ yt-dlp "https://www.youtube.com/watch?v=BaW_jenozKc"

指定清晰度（最高 1080p）

自动匹配最佳音轨并合并。

$ yt-dlp -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" "视频链接"

提取音频并转 MP3

适合播客、音乐与有声内容，需 FFmpeg。

$ yt-dlp -x --audio-format mp3 "视频链接"

下载整个播放列表

按「播放列表/标题」自动归档目录。

$ yt-dlp -o "%(playlist)s/%(title)s.%(ext)s" "播放列表链接"

下载中文字幕

下载并合并原生字幕，支持多语言。

$ yt-dlp --write-subs --sub-lang "zh,en" "视频链接"

跳过赞助商片段

SponsorBlock 自动标记或移除广告片段。

$ yt-dlp --sponsorblock-mark all "视频链接"

断点续传 + 并发加速

中断后不重复下载，8 线程并发加速。

$ yt-dlp -c -N 8 "视频链接"

批量导入链接

每行一个链接，配合输出模板批量下载。

$ yt-dlp -a urls.txt

更新到最新版本

保持站点适配与安全修复最新。

$ yt-dlp -U

只获取元数据

不下载文件，仅输出标题、时长等信息。

$ yt-dlp --skip-download --print-json "视频链接"

更完整的参数说明，请参阅官方文档 yt-dlp README · Usage and Options

Configuration

配置文件

把常用参数写入配置文件，每次运行自动生效，无需重复输入。

全局配置文件

在以下位置创建 config.txt：

# Windows：C:\Users\你的用户名\AppData\Roaming\yt-dlp\config.txt
# Linux / macOS：~/.config/yt-dlp/config.txt

配置示例

# 默认下载到 下载/视频 目录并归档
-o "下载/视频/%(title)s.%(ext)s"
--write-subs
--sub-lang zh,en
--embed-metadata
--embed-thumbnail
--sponsorblock-mark all
# 网络不佳时自动重试 3 次
--retries 3

FAQ

常见问题

遇到问题先看这里，大部分疑问都能得到解答。

yt-dlp 与 youtube-dl 有什么区别？

yt-dlp 是 youtube-dl 的活跃维护分支：更新频率更高、新站点适配更快，并新增 SponsorBlock、格式排序、并发下载、插件机制、嵌入 API 等大量新特性，同时保持命令行兼容。

为什么提示「ffmpeg not found」？

合并音视频流、格式转换需要 FFmpeg。请从 FFmpeg 官网或 yt-dlp 官方提供的适配版本安装，并确保其可执行文件已加入系统 PATH。

下载速度很慢怎么办？

可尝试并发下载 -N 8、断点续传 -c、使用 aria2c 外部下载器 --external-downloader aria2c，或检查网络与代理设置。

某个网站下载失败怎么办？

网站改版会导致提取器失效。请先执行 yt-dlp -U 更新到最新版本；若仍失败，可到 GitHub Issues 反馈，提供完整报错日志（--verbose 输出）。

需要登录的网站如何下载？

可使用 --cookies-from-browser 读取浏览器 Cookie，或 --cookies cookies.txt 指定文件；部分站点支持 -u/-p 账号密码参数。请仅下载你有权访问的内容。

如何验证下载文件的完整性？

官方每个发行版均提供 SHA2-256 / SHA2-512 校验和与 GPG 签名（SHA2-256SUMS.sig 等）。使用仓库中的公钥 public.key 验签，确保文件完整且来自官方。

下载受版权保护的内容是否合法？

yt-dlp 是合法的开源工具，请将其用于合法用途：仅下载你有权保存的内容（如公开内容、自有内容、获授权内容），遵守目标网站服务条款与当地法律法规，尊重内容版权。

yt-dlp 安全吗？会不会中毒？

yt-dlp 本身是安全的开源工具，从官方渠道（GitHub Releases / PyPI / 本站下载中心）下载不会有问题。最新版本 2026.07.04 已修复 CVE-2026-55404 等命令注入漏洞，建议保持 yt-dlp -U 及时更新。请勿下载第三方修改版。

yt-dlp 有中文版吗？怎么用？

yt-dlp 本身是命令行工具，界面与提示信息为英文。但官方支持列表中包含 B 站、抖音、微博、AcFun、芒果 TV、西瓜视频等大量中文站点；本站提供完整中文使用指南、安装命令与常见问题答疑，可以零障碍使用。

使用指南