跳到正文
yt-dlp

安装 yt-dlp

在 Windows、macOS 或 Linux 上安装 yt-dlp 和 ffmpeg,并验证安装是否成功。

选择你的系统

你几乎一定也需要 ffmpeg

没有 ffmpeg 时 yt-dlp 也能下载,但合并分离的视频和音频、提取 MP3、内嵌字幕或封面、裁剪片段都会调用 ffmpeg。一开始就装好,可以避免第一次运行时莫名其妙的失败。

验证安装是否成功

yt-dlp --version
ffmpeg -version

常见问题

我该选哪种安装方式?
选你已经在用的包管理器。唯一要避免的做法是把二进制文件随手扔在某处、指望 shell 能找到它 —— "yt-dlp is not recognized" 就是这么来的。
我真的需要 ffmpeg 吗?
只做普通下载不需要。但凡涉及合并视频与音频、转成 MP3、内嵌字幕或封面、裁剪片段的,就需要 —— 而这些正是大多数人真正想做的事。
怎么更新 yt-dlp?
独立的二进制文件用 yt-dlp -U 自我更新。如果是通过包管理器安装的,就用那个管理器更新;自我更新会拒绝改动不属于它的文件。更新能解决的问题比任何 flag 都多。
安装 yt-dlp 安全吗?
它是一个知名开源项目。请从它的官方发布页面,或你本来就信任的包管理器获取,并对随便某个下载站上的二次上传保持警惕 —— 麻烦都是从那里来的。