yt-dlp是什么？零基础教你用开源神器下载视频（附教程）

导语：yt-dlp 是一款免费开源的命令行视频下载工具，支持数千个网站的音视频下载，是 youtube-dl 的加强版。本文是零基础小白向的完整教程，从”它是什么”到”每一步怎么点鼠标、敲什么命令”，再到”报错了怎么办”，看完你就能独立下载视频。

项目地址：https://github.com/yt-dlp/yt-dlp

一、yt-dlp 是什么？

yt-dlp 是一个命令行音视频下载工具。通俗地说，它是一个”你输入一行命令，它就把网页上的视频或音频下载到你电脑”的软件。

很多小白对”命令行”这个词有畏难情绪，其实你可以把它理解成：电脑里有一个”文字窗口”，你在这个窗口里打字下达指令，电脑就会执行。yt-dlp 就是通过这个窗口来用的，全程只需要复制粘贴几条命令，不需要你懂编程。

打个比方：普通下载视频，你得去各种”在线视频解析”网站，把链接贴进去，等它解析，再点下载，麻烦不说，还经常失效、夹带广告。而 yt-dlp 就像一个装在你电脑里的万能搬运工——你把视频网址交给它，它自己去对应的网站（YouTube、B 站、Twitter/X、抖音、Instagram 等数千个网站）把视频或音频”搬”回你的电脑，稳定、干净、没有广告。

它还有一个重要的身世：它是大名鼎鼎的 youtube-dl 的”分叉加强版”。原来的 youtube-dl 因为更新慢、经常失效，社区就在它的基础上做出了 yt-dlp，修复了大量问题，并且保持极高频率的更新，现在已经是这个领域事实上的首选工具。

二、它到底有多火？

yt-dlp 是 GitHub 上最热门的开源项目之一（以下数据来自项目仓库页面，star 数以 GitHub 实时显示为准）：

• Star 数：超过 10 万，位列 GitHub 全站最受欢迎的 Python 项目之一。Star 可以理解为”收藏/点赞”，超过 10 万意味着有超过 10 万人主动收藏了它。
• 更新频率：几乎每天都在更新。这一点非常关键——视频网站会不断升级反爬机制来阻止下载，而 yt-dlp 靠这种”日更”节奏，能持续跟上变化，保证下载功能长期有效。
• 支持网站数量：数千个，官方维护了一份 supportedsites.md 列表，你可以随时去查某个网站是否在支持范围内。

一个项目能被这么多人收藏、还能保持如此高的更新频率，本身就说明它足够好用、足够可靠。

三、核心功能有哪些？

下面这些功能，每一项后面都附了一句大白话解释：

• 多平台下载：YouTube、B 站、Twitter/X、抖音、Instagram、Twitch 等数千个网站的视频都能下。
• 格式自由选择：可以只下载声音（转成 mp3 等音频格式当音乐/播客听），也可以下载视频的不同清晰度（从标清到 4K）。
• 字幕下载：一键把视频里的字幕文件抓下来，方便学习和翻译。
• 批量下载：支持下载整个播放列表、整个频道，不用一个视频一个视频地点。
• 自定义命名与归档：可以按标题、日期、作者等规则，自动给下载下来的文件命名、分类整理。
• 断点续传与限速：下载到一半断了可以接着下，不会从头再来；还可以限制下载速度，不影响你同时做别的事。

四、三步上手指南（零基础详细版）

下面我会把每一步拆得非常细，你照着做就行。整个流程可以概括为三步：① 装好它 → ② 下载第一个视频 → ③ 学会加参数。

第一步：安装 yt-dlp

安装这件事，不同系统的方法不一样，请你根据自己的电脑系统，只挑对应的那一段看。

情况 A：Windows 用户（最推荐，也最简单）

Windows 用户不需要安装 Python，只需要下载一个现成的可执行文件 yt-dlp.exe 即可。具体步骤：

1. 打开浏览器，访问 yt-dlp 的 GitHub 项目主页：https://github.com/yt-dlp/yt-dlp。
2. 在页面右侧找到 Releases（发行版） 一栏，点进去，会看到最新的版本和一堆下载文件。也可以直接访问下载页：https://github.com/yt-dlp/yt-dlp/releases/latest。
3. 找到文件名为 yt-dlp.exe 的那个（这就是 Windows 64 位的独立程序），点击下载。如果你的电脑是 32 位系统，就下载 yt-dlp_x86.exe；现在绝大多数电脑都是 64 位，选 yt-dlp.exe 即可。
4. 把下载好的 yt-dlp.exe 放进一个固定的文件夹，比如在 D 盘新建一个文件夹叫 D:\ytdlp，把文件放进去。这样做的目的是后面好找到它、也不会被误删。
5. （可选但推荐）把这个文件夹路径加入系统 PATH 环境变量，这样你在任何位置都能直接输入 yt-dlp 命令。这一步稍复杂，如果你是纯小白，也可以先跳过，直接在文件所在文件夹里运行命令即可（后面会讲怎么”在文件夹里打开命令行”）。

情况 B：Mac 用户

Mac 用户如果装了 Homebrew（一个 Mac 上的软件包管理工具），只需要打开”终端”，输入一行命令即可：

brew install yt-dlp

如果没装 Homebrew，可以先到 brew.sh 官网按照提示装一下，或者直接去 GitHub Releases 页面下载 Mac 版的可执行文件 yt-dlp_macos。

情况 C：Linux 用户

Debian / Ubuntu 系统，在终端里输入：

sudo apt install yt-dlp

其他发行版请以仓库 README 提供的安装方式为准。

第二步：下载你的第一个视频

这一步是整个教程的核心，请仔细跟着做。

2.1 先打开”命令行窗口”

• Windows：按下键盘上的 Win 键 + R（Win 键就是键盘左下角带窗户图标的那个键），会弹出一个小窗口，输入 cmd，然后按回车。这时会弹出一个黑色的窗口，这个窗口就是”命令行”，也叫”终端”。
• Mac：在”启动台”或”应用程序”里找到”终端（Terminal）”打开。

提示：如果你跳过了 PATH 环境变量的设置，Windows 用户需要先让命令行”进入”你存放 yt-dlp.exe 的文件夹。方法：在命令行里输入 cd /d D:\ytdlp（把路径换成你自己的），回车即可。

2.2 复制视频链接

打开你想下载的视频网页（比如 YouTube 上的某个视频），复制浏览器地址栏里的完整网址。

2.3 输入下载命令

回到命令行窗口，输入下面的命令（把”视频链接”替换成你刚复制的网址）：

yt-dlp 视频链接

举个完整例子：

yt-dlp https://www.youtube.com/watch?v=xxxxxxxx

输入后按回车。这时你会看到命令行开始”刷屏”，显示它正在解析、获取视频信息、然后开始下载，底部会出现一个进度条和下载速度。等它显示”完成”或进度条走到 100%，视频就下载好了。

2.4 下载好的文件在哪？

默认情况下，视频会下载到”当前目录”——也就是你命令行窗口里光标所在的那个文件夹。如果你没有做过路径设置，Windows 用户通常就是 D:\ytdlp 这个文件夹（或你运行命令时所在的文件夹）。

如果不确定，可以记一下：在下载命令后面加参数就能指定保存位置，这一点在第三步会讲。

第三步：学会几个最常用的参数

“参数”就是附加在命令后面的额外指令，用来控制下载行为。下面这几个是最常用的，你按需取用。

3.1 只下载音频（转成 mp3）

很多时候你只想要声音，比如想把一个视频当播客听、想下载一首歌，就用这个：

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

解释：-x 表示”只要音频”，--audio-format mp3 表示把音频转成 mp3 格式。

3.2 下载最高画质

默认情况下 yt-dlp 会选一个”够用”的画质，但如果你想强制下载最清晰的版本，用这个：

yt-dlp -f "bestvideo+bestaudio" 视频链接

解释：-f 表示指定格式，bestvideo+bestaudio 意思是”最好的视频 + 最好的音频”，然后会自动合成。

3.3 指定保存位置和文件名

想控制下载到哪、叫什么名字，用 -o 参数：

yt-dlp -o "D:/下载/%(title)s.%(ext)s" 视频链接

解释：-o 后面是保存路径模板。其中 %(title)s 会自动替换成视频标题，%(ext)s 会自动替换成文件扩展名（比如 mp4）。这样下载下来的文件就会放在 D:\下载 文件夹，并且以视频标题命名。

3.4 下载字幕

yt-dlp --write-subs --sub-lang zh-Hans 视频链接

解释：--write-subs 表示下载字幕，--sub-lang zh-Hans 表示优先下载简体中文字幕（可根据视频实际提供的语言调整）。

3.5 下载整个播放列表

yt-dlp 播放列表链接

其实和下载单个视频的命令一样，只要把播放列表的网址贴进去，yt-dlp 就会自动把列表里的所有视频逐个下载下来。

五、哪些人适合用？

• 视频/音频创作者：需要下载公开素材做二次创作、剪辑、配音的人，yt-dlp 能稳定高效地抓取素材。
• 程序员和技术爱好者：习惯命令行、追求效率和自动化，yt-dlp 还可以嵌入到自己的脚本里批量处理。
• 需要离线保存内容的人：想备份自己收藏的视频、网课、播客，防止链接失效或网站下架的人。
• 自媒体剪辑从业者：需要快速获取公开视频素材用于本地剪辑的人。

六、哪些人不建议用 / 需要避坑

这一节很重要，帮你判断自己是否值得投入时间，以及避免踩坑。

• 完全不想碰任何命令行的人：yt-dlp 没有图形界面，需要一点点命令行操作基础。虽然本文已经把步骤拆到最细，但如果你非常抗拒”黑窗口”，可能会觉得不习惯。
• 版权和法律问题：下载内容务必遵守目标网站的《服务条款》和当地法律法规，仅用于个人合法用途，不得下载受版权保护的内容用于商业传播或二次盈利。
• 可能遇到”下载报错”：部分网站会更新反爬机制，导致某个视频突然下载失败。这种情况通常不是工具坏了，而是需要升级。解决办法见下一节”常见问题排查”。
• 网络环境：某些境外网站（如 YouTube、Twitter）需要稳定的网络环境才能访问和下载。

七、常见问题排查（新手必看）

下面列出新手最容易遇到的几个问题，以及对应的解决办法。

问题 1：提示”不是内部或外部命令”（Windows）

含义：系统找不到 yt-dlp 这个程序，通常是因为你没设 PATH，或者当前命令行窗口不在 exe 所在文件夹。

解决办法：用 cd /d D:\ytdlp 先进入 exe 所在文件夹，再运行命令；或者把文件夹加入 PATH 环境变量。

问题 2：下载到一半报错、或某个视频下载失败

最常见的原因是版本过旧，跟不上网站的反爬更新。

解决办法：先升级到最新版，再重试。升级命令：

yt-dlp -U

升级后再跑一次下载命令，多数情况下就能恢复。

问题 3：提示”unsupported URL”（不支持的网址）

含义：这个网站不在支持范围内，或者链接格式不对。

解决办法：去仓库的 supportedsites.md 列表里查一下该网站是否支持；确认链接是完整的视频页网址，而不是首页。

问题 4：下载很慢

可以给下载限速或指定代理。如果你想限速，可以加参数限制下载速度（单位为字节/秒）。不过一般家用网络直接下即可，慢通常是网络环境本身的问题。

八、总结

yt-dlp 是目前功能最强、更新最快的开源命令行视频下载工具，支持数千个网站、格式灵活、可批量自动化。它适合有一定动手能力的创作者、程序员和技术爱好者——所谓”动手能力”，其实只需要你愿意照着本文敲几行命令。一旦你花十几分钟学会，就等于拥有了一个”几乎什么视频都能下”的利器，而且长期免费、无广告。

最后再强调一句：使用它时务必遵守版权和网站条款，只做合法用途。希望这篇教程能帮你顺利上手。