注意： 请在合规范围内使用该工具，仅用于个人学习和技术研究。

一、 环境准备：不可或缺的 FFmpeg

在安装 yt-dlp 之前，必须先安装 FFmpeg。

• 作用：yt-dlp 负责找资源，FFmpeg 负责将下载好的视频流和音频流合并成一个文件。如果不装它，你可能只能下载到没有声音的 720p 视频。
• 下载地址： FFmpeg，这是 FFmpeg 官方推荐的 Windows 编译版本发布站，在 “git master builds” 部分，点击下载 ffmpeg-git-full.7z。Mac用户下载地址

二、安装 yt-dlp

1、Windows 用户（推荐方式）

• 直接 GitHub Releases 下载最新的 yt-dlp.exe
• 建议：将其放在一个固定文件夹（如 D:\tools\yt-dlp\），并把该路径加入系统环境变量。这样你可以在任意文件夹打开命令行直接使用。

2、Python 用户（全平台通用）

# 如果你电脑有 Python 环境，一行命令搞定：
pip install -U yt-dlp

3、macOS 用户

# 使用 Homebrew 安装：
brew install yt-dlp

三、常用命令

1、基础下载（最高画质）

yt-dlp "视频链接"

2、查看所有可选格式

yt-dlp -F "视频链接"

3、指定格式下载

# 根据上面查到的 ID，下载指定的视频（ID 100113）和音频（ID 30280）
yt-dlp -f 100113 +30280 "视频链接"

4、内容转换与提取

（1）仅下载音频（转换为 MP3）

# -x 表示提取音频，--audio-format 指定格式
yt-dlp -x --audio-format mp3 "视频链接"

（2）强制合并为 MP4

# 有的视频格式是 .webm，如果你嫌 .webm 格式不方便剪辑：
yt-dlp --merge-output-format mp4 "视频链接"

5、字幕处理

# 列出所有字幕
yt-dlp --list-subs "URL"

# 下载视频并嵌入软字幕
yt-dlp --write-auto-subs --embed-subs --sub-lang zh-Hans,en "URL"

6、批量与自动化（懒人必备）

# 下载整个播放列表
yt-dlp --yes-playlist "URL"

# 从文本文件批量下载，建立一个 list.txt，一行一个链接：
yt-dlp -a list.txt

# 自定义文件名
# 油管/B站 这种正规视频网站，会自动抓取网页上的标题，文件名一目了然。
yt-dlp -a list.txt -o "%(title)s.%(ext)s"
# 如果是 M3U8，选这个
# --concurrent-fragments 5: 开启 5 线程下载（加速 M3U8 的切片下载）
yt-dlp -a urls.txt -o "视频_%(autonumber)02d.%(ext)s" --concurrent-fragments 5

7、权限与身份（解决“无法下载”的核心）

# 当你下载会员视频时，必须使用这些：

# 1、最常用：从浏览器自动获取登录态
# 支持 chrome, edge, firefox, safari, opera, vivaldi
yt-dlp --cookies-from-browser chrome "URL"

# 2、手动指定 Cookie 文件（最稳妥）
# 在 Chrome 应用商店 中扩展程序中搜索 Get cookies.txt LOCALLY，然后安装扩展，登录到对应网站登录之后，点击安装的扩展程序，然后 Export 当前网站的 Cookies，然后和 yt-dlp 放到同一目录下，即可正常使用
yt-dlp --cookies cookies.txt "URL"

# 3、视频网站（尤其是 YouTube 和 B 站）经常会更新其网页代码或加密算法，导致旧版的 yt-dlp 突然失效。如果不定期运行这个命令，你很快就会遇到各种报错。
yt-dlp -U

8、配置文件

对于习惯固定下载偏好的用户来说，配置文件（Config file） 是 yt-dlp 的终极进阶玩法。它能让你把一长串复杂的参数（如画质限制、Cookies 路径、字幕设置）存起来，以后运行只需输入 yt-dlp “URL”。

（1）配置文件放在哪里？

• 在 Windows 上，最简单的方法是创建“本地配置文件”：
• 在你存放 yt-dlp.exe 的同一个文件夹内，新建一个文本文档。
• 将其重命名为 yt-dlp.conf（注意：后缀名必须是 .conf，不能是 .txt）

（2）配置文件里写什么？

你可以把平时常用的命令一行行写进去。开头不需要加 yt-dlp，直接写参数即可。 以下是一个非常全能的“万金油”配置，你可以直接复制进去：

# --- 基础设置 ---
# 永远下载最高画质视频和最高音质音频
-f "bestvideo+bestaudio/best"

# 优先合并为 mp4 格式（为了兼容性）
--merge-output-format mp4

# --- 存储设置 ---
# 自动按“标题.后缀”命名，避免乱码和冗余 ID
-o "%(title)s.%(ext)s"

# --- 身份与权限 ---
# 自动读取 Chrome 浏览器的登录状态（下载会员/Patreon 视频必备）
--cookies-from-browser chrome

# --- 字幕设置 ---
# 下载自动生成的字幕，转为 srt 格式并嵌入视频
--write-auto-subs
--convert-subs srt
--embed-subs
--sub-lang zh-Hans,en

# --- 其他 ---
# 如果下载中断，自动断点续传
--continue

（3）如何使用？

一旦文件夹里有了这个 yt-dlp.conf 文件，你的操作将变得极其简单：

• 原本的痛苦操作：
  yt-dlp -f “bestvideo+bestaudio” --merge-output-format mp4 --cookies-from-browser chrome --write-auto-subs --embed-subs “URL”
• 现在的丝滑操作：
  直接输入：./yt-dlp “URL”

yt-dlp 会自动扫描同目录下的配置文件，并把里面的参数全部加上。

（4）进阶：多个配置文件（针对不同需求）

如果你有时想下视频，有时只想下 MP3，你可以创建不同的配置文件：

• 比如创建一个 mp3.conf，里面只写提取音频的参数。
• 使用时输入：yt-dlp --config-location mp3.conf “URL”

9、工具

如果不想折腾命令行，可以直接去下载基于 yt-dlp 的 Windows/Mac 视频下载工具。下载地址：https://github.com/JCObject/YtDlpDownloader
本文仅供技术交流，请自觉遵守相关法律法规，不得将相关技术用于非法用途。