yt-dlp 中文版

简介

yt-dlp 是一款命令行音视频下载器，可以从一千多个网站取回视频与音频，也是 youtube-dl 一脉的分支，其参考的 youtube-dlc 项目已停止维护。它解决的是网页只有播放按钮、没有下载入口时，内容如何离线留存的问题。适合做素材归档的剪辑者、需要保留字幕与封面图的研究者，以及希望用一条命令重复执行下载任务的人。核心优势在于格式可以逐项挑选、音视频分离流能够合并、字幕与缩略图能一并取回，并且覆盖 YouTube 与优酷、爱奇艺、bilibili 等站点。

核心功能

• 支持一千多个网站的视频与音频下载，除 YouTube 外还覆盖国内的优酷、爱奇艺、bilibili 等站点。
• 用 -F 列出当前地址可用的格式清单，再用 -f 指定格式编号或组合，避免盲目取最高清晰度。
• 可自动抓取字幕与缩略图，适合需要同时留存双语字幕和封面图做资料归档的场景。
• 支持多流下载，能把分开的视频流与音频流分别取回，再合并成一个文件。
• 音视频、字幕与相关元数据的处理交给 ffmpeg 完成，yt-dlp 负责取流与调度。
• 提供配置文件机制，且存放方式与 youtube-dl 不同，可把常用参数固化下来反复使用。
• 纯命令行形态，一条命令即可完成一次下载，便于写进批处理或脚本里重复执行。

使用场景

• 网页上没有下载按钮，只想把某条视频离线留存，粘贴地址即可取回。
• 整理视频素材时需要同时拿到画面、音轨、字幕和缩略图，而不是只有画面。
• 从国内视频站（优酷、爱奇艺、bilibili）取材，作为剪辑参考或研究样本。
• 站点把音视频分成两条流，直接保存会出现只有画面或只有声音的情况，需要合并为一个文件。
• 需要在 Windows 等环境下用一条命令重复执行下载，减少逐次手工点击。

安装与获取步骤

1. 准备好 Python 环境后执行 pip install yt-dlp，这是最常见的获取方式。
2. 不想用 pip 的，前往 https://github.com/yt-dlp/yt-dlp#release-files 下载对应系统的 exe 版本，放到 PATH 目录中再在命令行调用。
3. 以 Windows 为例，先到 ffmpeg 官网下载与电脑系统匹配的版本，因为音视频、字幕与元数据的处理依赖它。
4. 在命令行执行 yt-dlp 视频地址，确认能正常取回文件。
5. 执行 yt-dlp -F 视频地址 查看格式清单，再用 -f 选定格式；需要音视频合并时按 -f bv*+ba 这类组合写法指定。

与 youtube-dl 的差异

• yt-dlp 是 youtube-dl 的分支，而它参考的 youtube-dlc 项目已停止维护，两者的发展路线不同。
• 默认不允许把多个音频/视频流合并到一个文件，这与 -f bv*+ba 的写法冲突，需要额外参数才能开启。
• 配置文件的存储方式与 youtube-dl 略有不同，迁移旧配置前要先确认实际路径。
• -F 输出的格式列表与 youtube-dl 的呈现不完全一致，读取字段时以实际打印结果为准。
• Arch Linux 中文维基、GitHub 中文文档与多篇中文教程都收录了它的用法，可交叉核对参数写法。

常用参数速查

• -F：列出该地址可用的格式清单，是挑选清晰度与音轨的第一步。
• -f：按编号或组合指定要取的格式，音视频分离时常见 bv*+ba 形式。
• --audio-multistreams：需要把多个音频流合并时配合使用，完整写法以官方文档为准。
• 配置文件：存放位置与 youtube-dl 不同，可写入常用参数避免每次重复输入。
• ffmpeg：媒体处理的推荐选项，avconv 不被接受为它的替代品。

注意事项

• yt-dlp 默认不合并多个音频/视频流，与 -f bv*+ba 冲突；确有需要时必须使用 --audio-multistreams 及相应的视频多流参数，完整写法以官方文档为准。
• ffmpeg 是处理媒体的推荐选项，但 yt-dlp 不支持把 avconv 当作它的替代项，缺少 ffmpeg 时合并与转码步骤无法完成。
• 配置文件的存放位置与 youtube-dl 不同，直接沿用旧路径可能读不到已保存的参数。
• 受支持网站列表会随站点改版变化，遇到某个地址取不回时先核对官方的受支持网站列表，以官方页面为准。
• 不同来源的清晰度与字幕轨数量并不固定，-F 打印的清单才是判定标准，不要照搬别人给出的格式编号。
• 取回内容的使用需遵守来源站点的条款与相关法规，涉及转载与二次分发时先确认授权。