如何用ytdl/ytdlp下载含嵌入章节信息的完整YouTube播放列表

错误原因 #

你提供的播放列表命令参数顺序错误：-o（输出路径参数）后直接跟了--yes-playlist，导致yt-dlp误将--yes-playlist识别为输出文件名。而播放列表包含多个视频，固定文件名无法对应多文件下载，因此触发Fixed output name but more than one file to download错误，同时命令解析异常引发'list' is not recognized提示。

正确命令 #

以下两种方式都可以正常下载整个播放列表并为每个视频嵌入章节：

方式1：使用播放列表专属链接（无需--yes-playlist） #

yt-dlp -f "bestvideo[height<=720]+bestaudio/best[height<=720]" -o "%USERPROFILE%\Desktop\%(title)s-%(id)s.%(ext)s" --embed-chapters https://www.youtube.com/playlist?list=PLI84Sf0aDgazRojpYTLTXFE6Iaf5bkYr_

方式2：使用带列表参数的视频链接（需--yes-playlist） #

yt-dlp -f "bestvideo[height<=720]+bestaudio/best[height<=720]" --yes-playlist -o "%USERPROFILE%\Desktop\%(title)s-%(id)s.%(ext)s" --embed-chapters https://www.youtube.com/watch?v=ywyQ_eNNCJU&list=PLI84Sf0aDgazRojpYTLTXFE6Iaf5bkYr_

关键参数说明 #

• -f "bestvideo[height<=720]+bestaudio/best[height<=720]"：优先下载720P以内的最佳视频流+最佳音频流，若无法合并则直接下载720P以内的最佳合并流
• --yes-playlist：强制识别链接中的播放列表并下载全部视频（仅在使用带list参数的视频链接时需要）
• -o "%USERPROFILE%\Desktop\%(title)s-%(id)s.%(ext)s"：将视频保存到桌面，文件名格式为「视频标题-视频ID.扩展名」，避免批量下载时文件名冲突
• --embed-chapters：自动将每个视频的章节信息嵌入到下载后的文件中（支持MP4、MKV等主流格式）

内容的提问来源于stack exchange，提问作者Good Boy