YT-DLP :基于 youtube-dl 的命令行视频下载工具

目录

一、YT-DLP介绍

二、使用方法

三、常用命令

1.下载单个视频（默认最高画质）

2.下载整个播放列表

3.批量下载

4.限制速度（防止被封锁）：

5.指定保存文件夹

6.自动命名

7.下载最佳文件

[8.生成"文件名 + 链接"对照表（推荐）](#8.生成“文件名 + 链接”对照表（推荐）)

9.获取详细元数据（标题、时长、描述等）

一、YT-DLP介绍

支持范围：支持 YouTube、B 站、抖音、TikTok、Vimeo 等视频网站。

优点：更新频率更高，支持更多新网站，并且功能更强（支持分段下载、多线程、外挂字幕、直播录制等）。

下载地址：

GitHub - yt-dlp/yt-dlp: A feature-rich command-line audio/video downloader · GitHub

二、使用方法

1.访问 GitHub 的 yt-dlp 官方发布页面。

2.在 "Assets" 列表中，下载 yt-dlp.exe（Windows）或直接下载源码。

3.配置环境变量（可选）

为了在任何文件夹都能直接输入 yt-dlp 命令，需要把它加入系统路径：

1. 例如：在 C 盘根目录创建一个文件夹，例如 C:\yt-dlp。

2. 把下载好的 yt-dlp.exe 放入这个文件夹。

3. Windows 设置：

   a. 按 Win 键，搜索"编辑系统环境变量"。
   b. 点击"环境变量"按钮。
   c. 在"系统变量"里找到 Path，选中并点击"编辑"。
   d. 点击"新建"，输入刚才的文件夹路径：C:\yt-dlp。

4.打开终端CMD，然后输入下载命令，即可进行视频下载。

三、常用命令

1.下载单个视频（默认最高画质）

yt-dlp 视频链接

2.下载整个播放列表

yt-dlp -f 137+140 "https://www.youtube.com/playlist?list=XXXXXXX"

3.批量下载

新建一个文本文档（例如 list.txt）将所有视频链接粘贴进去，每行一个链接。

yt-dlp -a list.txt

4.限制速度（防止被封锁）：

yt-dlp -a list.txt --sleep-interval 5

5.指定保存文件夹

yt-dlp -a list.txt -P "D:\Downloads\MyVideos"

6.自动命名

可以使用 -o 参数自定义命名模板（例如加上标题和分辨率）。

yt-dlp -a list.txt -o "%(title)s.%(ext)s"

7.下载最佳文件

"合并流"格式（最快，无需转码，单个文件，也可以下载音视频分开的文件）

YouTube 也提供一些预合并的格式（通常画质上限是 720p 或 1080p），直接下载单文件。

yt-dlp -f "best[ext=mp4]" https://www.youtube.com/watch?v=7qlY0vWoO1k

8.生成"文件名 + 链接"对照表（推荐）

利用 --print 参数，在下载完成后，将"原始链接"和"最终文件名"打印出来，并直接写入到一个专门的统计文件中。

yt-dlp -a list.txt --print "%(webpage_url)s；%(filename)s" > mapping.txt

注意：> mapping.txt是覆盖，>>mapping.txt是追加。

也可以生成别的格式 ：--print-to-file "%(webpage_url)s,%(filename)s" "report.csv"

或者输出标准JSON格式：--print-to-file "%(json)" "metadata.json"

9.获取详细元数据（标题、时长、描述等）

**方法1：**导出完整数据 JSON

yt-dlp -a list.txt --dump-json > all_info.jsonl

方法2：--print简单拼接法

利用 --print 参数，手动指定用逗号 , 分隔各个字段。

yt-dlp -a list.txt --print "%(title)s,%(uploader)s,%(duration)s,%(webpage_url)s" > info.csv

常用参数对照表：

字段代码	含义	示例
%(title)s	标题	宣传视频
%(uploader)s	上传者	CCTV
%(duration_string)s	时长	02:15
%(upload_date)s	上传日期	20260417
%(view_count)s	观看次数	10000
%(like_count)s	点赞数	500
%(webpage_url)s	链接	https://...
%(description)s	简介	(长文本)
%(filename)s	下载文件名	宣传视频xssss.mp4

其他命令，可以自行研究。