最常用 yt-dlp 命令和选项的快速参考指南。
yt-dlp 是一个开源命令行工具，是 youtube-dl 的积极维护分支（提供更快的 bug 修复和 1700+ 网站支持），用于下载视频、音频和播放列表。
此速查表涵盖下载 1080p/4K 视频、提取 MP3 音频、绕过机器人检测和嵌入字幕的常用命令。
初次使用？请访问我们的全面 yt-dlp 下载与安装指南，或者直接在我们的 在线控制台 无需任何设置。
更喜欢自己构建命令？试试我们交互式的 yt-dlp 命令生成器 — 选择选项并获取准确的命令。
yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0"
yt-dlp -x --audio-format mp3 "https://soundcloud.com/..."
yt-dlp -F "https://vimeo.com/..."
yt-dlp -f "best[height<=1080]" "https://www..."
yt-dlp --yes-playlist "https://www.youtube/..."
yt-dlp --embed-subs "https://www..."
| 命令 | 描述 | 操作 |
|---|---|---|
| yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 下载最佳质量的视频（默认行为）。 | |
| yt-dlp -o "%(title)s.%(ext)s" "https://vimeo.com/906834164" | 使用自定义输出路径和文件名模板保存视频。 | |
| yt-dlp --limit-rate 50K "https://www.dailymotion.com/video/x8j5y9z" | 限制下载速度以绕过带宽限速（例如 50K、10M）。 | |
| yt-dlp -o "%(upload_date)s - %(title)s (%(id)s).%(ext)s" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 通过在输出文件名中嵌入上传日期和唯一视频 ID 来避免文件冲突。 |
| 命令 | 描述 | 操作 |
|---|---|---|
| yt-dlp -F "https://vimeo.com/906834164" | 列出所有可用的分辨率、大小、编解码器和格式。 | |
| yt-dlp -f 137 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 选择并下载特定的格式代码（先使用 -F 查找代码）。 | |
| yt-dlp -f "bestvideo[height<=1080]+bestaudio/best" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 下载 1080p 及以下的最佳视频质量。相同的高度过滤器适用于 1440p (2K) 和 2160p (4K)。 | |
| yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]" --merge-output-format mp4 "https://vimeo.com/906834164" | 强制以合并的 MP4 格式下载最佳质量。 | |
| yt-dlp --recode-video mp4 "https://www.dailymotion.com/video/x8j5y9z" | 下载视频并重新编码为标准 MP4（适用于平台使用 WebM 等非标准容器时）。 |
-f bestvideo+bestaudio 搭配 --merge-output-format mp4 获取最佳质量和最大设备兼容性。在 ytdlp.online 上，ffmpeg 合并在服务器端自动处理。
| 命令 | 描述 | 操作 |
|---|---|---|
| yt-dlp -x "https://soundcloud.com/monstercat/aero-chord-surface" | 仅提取音频轨道（自动检测最佳默认格式）。 | |
| yt-dlp -x --audio-format mp3 "https://soundcloud.com/monstercat/aero-chord-surface" | 下载音频并将其转换为 MP3 格式。 | |
| yt-dlp -x --audio-format mp3 --audio-quality 0 "https://soundcloud.com/monstercat/aero-chord-surface" | 下载音频并提取为最佳质量 MP3（VBR 0 / 等效 320kbps）。 | |
| yt-dlp -x --audio-format mp3 --embed-thumbnail --embed-metadata "https://soundcloud.com/monstercat/aero-chord-surface" | 下载 MP3 并嵌入原始视频描述、标签和缩略图封面。 |
--embed-thumbnail --embed-metadata 可自动获取专辑封面和歌曲标签——非常适合 iTunes 或 Spotify 本地文件等音乐库应用。
| 命令 | 描述 | 操作 |
|---|---|---|
| yt-dlp --yes-playlist "https://www.youtube.com/playlist?list=PLRBp0Fe2GpgnIh0AiYKh7o7HnYAej-5ph" | 强制下载播放列表链接中的所有视频。 | |
| yt-dlp --no-playlist "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 仅下载 URL 中的单个视频，忽略其所属的播放列表。 | |
| yt-dlp --playlist-items 1-5 "https://www.youtube.com/playlist?list=PLRBp0Fe2GpgnIh0AiYKh7o7HnYAej-5ph" | 下载播放列表的指定索引范围（例如 1-5、1,3,5）。 |
| 命令 | 描述 | 操作 |
|---|---|---|
| yt-dlp --list-subs "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 列出所有手动上传和自动生成的字幕。 | |
| yt-dlp --write-auto-subs --skip-download "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 仅提取和保存自动生成的字幕文件，跳过视频下载。 | |
| yt-dlp --embed-subs --merge-output-format mp4 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 下载视频并自动将字幕作为软字幕嵌入合并的 MP4 文件中。 | |
| yt-dlp --write-subs --sub-langs en "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 下载特定语言的手动上传字幕（例如 en、zh-Hans、ja）。先使用 --list-subs 查看可用语言。 |
--sub-langs all 下载所有可用语言的字幕，或使用 --sub-langs "en,zh-Hans" 一次抓取多种语言。如需完整字幕参考，请查看我们的 yt-dlp 帮助页面.
| 命令 | 描述 | 操作 |
|---|---|---|
| yt-dlp --cookies-from-browser chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 从浏览器（例如 chrome、firefox）加载 Cookie 以绕过登录验证或机器人检测。 |
|
| yt-dlp --impersonate chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 模拟浏览器 TLS 客户端特征（需要 curl-cffi）以绕过 Cloudflare 和 YouTube 机器人检测封锁。 | |
| yt-dlp --extractor-args youtube:player_client=default,-android_sdkless "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 通过强制使用特定的 YouTube 播放器客户端组合来绕过"请登录以确认您不是机器人"错误。 | |
| yt-dlp --proxy "http://proxy-ip:port" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 通过 HTTP、HTTPS 或 SOCKS 代理路由 yt-dlp 流量——适用于地理限制内容。 | |
| yt-dlp --geo-bypass-country US "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 伪造地理位置国家代码（例如 US、GB、JP）以绕过地区内容限制。 |
| 命令 | 描述 | 操作 |
|---|---|---|
| yt-dlp -a urls.txt | 批量下载文本文件中逐行列出的所有视频 URL。 |
|
| yt-dlp --split-chapters "https://www.youtube.com/watch?v=QQ7Xl79OqNY" | 根据视频内部章节自动将视频拆分为单独的轨道/文件。 | |
| yt-dlp --external-downloader aria2c "https://vimeo.com/906834164" | 使用外部多线程下载器（Aria2）显著加速下载。 | |
| yt-dlp --sleep-interval 5 --max-sleep-interval 15 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 在下载之间强制随机延迟（5 到 15 秒）以防止 IP 被封禁。 | |
| yt-dlp --download-sections "*00:01:00-00:02:30" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 下载特定的视频片段或时间范围（例如 1m0s 到 2m30s），而非整个视频。 | |
| yt-dlp --download-archive archive.txt "https://www.youtube.com/watch?v=oHg5SJYRHA0" | 在 archive.txt 中跟踪下载历史，自动跳过之前已下载的视频。 |
|
yt-dlp --cookies-from-browser chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0"
yt-dlp -U
winget install yt-dlp。您也可以使用 Scoop、Chocolatey、pip，或直接从 GitHub 下载独立的 yt-dlp.exe。