yt-dlp 是一个强大的命令行工具，用来下载 YouTube 和其他网站上的视频和音频。它拥有丰富的参数，可以定制下载行为，满足各种需求。本文将详细介绍 yt-dlp 的参数使用。

一、基本参数

• -f, –format FORMAT: 指定下载格式，可以用视频编号或格式别名。
  • -f bestvideo: 下载最佳视频质量。
  • -f best: 下载最佳音频和视频质量。
  • -f 137: 下载 1080p 视频 (h264)。
  • -f 140: 下载 1440p 视频 (h264)。
  • -f 22: 下载 720p 视频 (h264)。
  • -f 18: 下载 360p 视频 (h264)。
  • -f 171: 下载 1080p 视频 (vp9)。
  • -f 134: 下载 720p 视频 (vp9)。
  • -f 133: 下载 480p 视频 (vp9)。
  • -f 135: 下载 240p 视频 (vp9)。
  • -f 140: 下载 1440p 视频 (h264)。
  • -f 249: 下载 1080p 视频 (av1)。
  • -f bestaudio: 下载最佳音频质量。
  • -f m4a: 下载音频为 m4a 格式。
  • -f mp3: 下载音频为 mp3 格式。
  • -f 140: 下载 1440p 视频 (h264)。
• -o, –output TEMPLATE: 指定输出文件名模板。
  • -o ‘%(title)s.%(ext)s’: 文件名包含视频标题和扩展名。
  • -o ‘%(id)s-%(title)s.%(ext)s’: 文件名包含视频 ID、标题和扩展名。
• –no-playlist: 只下载播放列表中的第一个视频。
• -r, –rate-limit RATE: 设置下载速度限制，单位是 KB/s。
• –retries RETRIES: 设置下载失败重试次数。
• –verbose: 显示详细的下载信息。
• –no-warnings: 不显示警告信息。

二、高级参数

• –playlist-items ITEM_SPEC: 指定下载播放列表中的特定视频，例如 –playlist-items 1,3,5-7。
• –embed-thumbnail: 将视频缩略图嵌入到视频文件中。
• –write-info-json: 将视频信息写入 JSON 文件。
• –write-thumbnail: 下载视频缩略图。
• –force-ipv4: 使用 IPv4 网络连接。
• –force-ipv6: 使用 IPv6 网络连接。
• –proxy SERVER: 设置代理服务器。
• –ignore-errors: 忽略下载错误，继续下载其他视频。
• –download-archive FILE: 将已下载视频信息写入文件，避免重复下载。
• –write-sub: 下载字幕。
• –sub-lang en: 指定字幕语言为英文，可以根据实际情况更改。

使用举例

yt-dlp https://www.youtube.com/playlist?list=PL12345 -f 137 –no-playlist –output ‘%%(playlist)s/%(id)s-%(title)s.%(ext)s’

上面命令将下载播放列表 “PL12345” 中的所有视频（1080格式），并将其保存在 “PL12345” 文件夹中，文件名格式为 “视频 ID-视频标题.mp4″。

yt-dlp -f bestvideo+bestaudio -o “%(title)s.%(ext)s” –write-sub https://www.youtube.com/watch?v=油管视频ID

上面命令是下载最佳视频和音频质量，并下载字幕

yt-dlp https://www.youtube.com/watch?v=油管视频ID -f 140 –embed-thumbnail

上面命令将下载 视频的 1440p 视频 (h264)，并将缩略图嵌入到视频文件中。

yt-dlp不仅可以下载youtube视频，还支持很多视频网站，包括国内的b站，这个工具很实用，建议收藏。

页面地址 视频网站下载利器yt-dlp参数详解 – AI小站