yt-dlp 实用命令速查手册
基于实际使用经验，涵盖单个视频/播放列表下载、画质选择、格式控制等核心场景。所有命令均可在 Windows PowerShell 或 CMD 中运行（注意引号区别）。
一、准备工作（极简）
-
下载并放在同一文件夹 （如
D:\yt-dlp）：yt-dlp.exe（主程序）ffmpeg.exe（用于合并音视频，必需）aria2c.exe（可选，用于多线程加速）
-
验证 ：在该文件夹打开 PowerShell，运行
.\yt-dlp --version看到版本号即可。
二、核心参数速查
| 参数 | 作用 | 示例 |
|---|---|---|
-P |
指定下载目录 | -P "D:/mv" |
-o |
自定义文件名（支持占位符） | -o "视频标题.%(ext)s" |
-f |
选择画质/格式 | -f "137+140"（H.264 1080P+AAC） |
--merge-output-format |
强制输出容器格式 | --merge-output-format mp4 |
--downloader |
指定下载器（aria2c 加速） | --downloader aria2c |
--downloader-args |
aria2c 参数 | --downloader-args "aria2c:-x 16 -k 1M" |
--no-playlist |
只下载单视频（忽略列表） | --no-playlist |
--playlist-items |
下载列表的部分视频 | --playlist-items 1-5,8 |
PowerShell 特别注意 ：
-o中的占位符要用 单引号 包裹，例如-o '%(title)s.%(ext)s'，否则会解析失败。
三、常用命令（含 aria2c 加速版 & 标准版）
场景1：下载单个视频，指定 H.264 1080P + AAC，输出 MP4
适用：追求最大兼容性（任何播放器都能播）
powershell
# 推荐：aria2c 多线程加速
yt-dlp -P "D:/mv" -o "今生多相见.%(ext)s" --downloader aria2c --downloader-args "aria2c:-x 16 -k 1M" -f "137+140" --no-playlist "https://youtu.be/41AIEPVXLUw"
# 不推荐：标准下载器（速度慢，仅当无法安装 aria2c 时使用）
yt-dlp -P "D:/mv" -o "今生多相见.%(ext)s" -f "137+140" --no-playlist "https://youtu.be/41AIEPVXLUw"场景2：下载单个视频，让 yt-dlp 自动选最佳画质（可能为 VP9 WebM）
适用：追求最佳画质/体积比，播放器支持 VP9
powershell
# 推荐：aria2c 加速
yt-dlp -P "D:/mv" -o "今生多相见.%(ext)s" --downloader aria2c --downloader-args "aria2c:-x 16 -k 1M" -f "bestvideo[height=1080]+bestaudio/best[height<=1080]" --no-playlist "https://youtu.be/41AIEPVXLUw"
# 不推荐：标准下载器
yt-dlp -P "D:/mv" -o "今生多相见.%(ext)s" -f "bestvideo[height=1080]+bestaudio/best[height<=1080]" --no-playlist "https://youtu.be/41AIEPVXLUw"场景3：下载整个播放列表，自动选最佳画质，强制输出 MP4，按序号命名
适用：批量下载，保持列表顺序
powershell
# 推荐：aria2c 加速
yt-dlp -P "D:/mv" -o '%(playlist_title)s/%(playlist_index)s - %(title)s.%(ext)s' --downloader aria2c --downloader-args "aria2c:-x 16 -k 1M" -f "bestvideo[height=1080]+bestaudio/best[height<=1080]" --merge-output-format mp4 "https://youtube.com/playlist?list=RD41AIEPVXLUw"
# 不推荐：标准下载器
yt-dlp -P "D:/mv" -o '%(playlist_title)s/%(playlist_index)s - %(title)s.%(ext)s' -f "bestvideo[height=1080]+bestaudio/best[height<=1080]" --merge-output-format mp4 "https://youtube.com/playlist?list=RD41AIEPVXLUw"场景4：下载播放列表，使用精细化降级逻辑（1080P→720P→...）并优先 MP4
适用：列表中存在老视频，可能没有 1080P 或 MP4 格式
powershell
# 推荐：aria2c 加速
yt-dlp -P "D:/mv" -o '%(playlist_title)s/%(playlist_index)s - %(title)s.%(ext)s' --downloader aria2c --downloader-args "aria2c:-x 16 -k 1M" -f "bestvideo[height<=1080][ext=mp4]+bestaudio[ext=m4a]/bestvideo[height<=1080]+bestaudio/best[height<=1080]" --merge-output-format mp4 "https://youtube.com/playlist?list=PL74BRlOuPurd-QnPZwzj9NMuUo1AaHl_W"
# 不推荐：标准下载器
yt-dlp -P "D:/mv" -o '%(playlist_title)s/%(playlist_index)s - %(title)s.%(ext)s' -f "bestvideo[height<=1080][ext=mp4]+bestaudio[ext=m4a]/bestvideo[height<=1080]+bestaudio/best[height<=1080]" --merge-output-format mp4 "https://youtube.com/playlist?list=PL74BRlOuPurd-QnPZwzj9NMuUo1AaHl_W"四、一句话总结各参数
137+140→ 最稳的 MP4 组合，但画质可能不是最佳（YouTube 优先推 VP9）。bestvideo[height=1080]+bestaudio→ 画质最佳，但可能输出.webm（加上--merge-output-format mp4可强制转 .mp4）。--merge-output-format mp4→ 把任何组合封装成 .mp4 文件（需 ffmpeg）。--downloader aria2c ...→ 提速利器，强烈推荐，但需额外下载aria2c.exe。--no-playlist→ 防止误下载整个列表（当 URL 含&list=时）。
五、常见问题
Q：加了 --downloader aria2c 但速度没变？
A：请确认 aria2c.exe 和 yt-dlp.exe 在同一目录，或在 PATH 中。运行 aria2c --version 测试。
Q：文件名模板不生效，直接显示 %(title)s.mp4？
A：在 PowerShell 中必须用 单引号 ，如 -o '%(title)s.%(ext)s'。CMD 中可以用双引号。
Q：提示 ERROR: unable to download video data？
A：YouTube 临时抽风，稍后重试或更新 yt-dlp：yt-dlp -U。
六、最后提醒
- aria2c 版速度更快，能充分利用带宽，强烈推荐。 标准下载器仅作为无法安装 aria2c 时的备选。
- 尊重版权，合理使用。