2023 年 2 月 15 日更新：

由于 YouTube 调整了，目前无法使用 youtube-dl 下载 YouTube 视频，建议使用 yt-dlp 下载。yt-dlp 是从 youtube-dl 而来，基本用法都一样，这里是安装说明。

youtube-dl 是一款命令行下的视频下载工具，看着名称像是 YouTube 下载工具，其实这款工具不仅支持 YouTube ，还支持非常多的视频网站，比如优酷、爱奇艺、 bilibili 等，在写这篇日志的时候，暂时不支持腾讯视频。

youtube-dl 常用地址：

• 官网：https://ytdl-org.github.io/youtube-dl/index.html
• github：https://github.com/ytdl-org/youtube-dl/
• 支持的网站：https://github.com/ytdl-org/youtube-dl/blob/master/docs/supportedsites.md

youtube-dl 的安装

linux 下的安装方法：

wget https://yt-dl.org/downloads/latest/youtube-dl -O /usr/local/bin/youtube-dl
chmod a+rx /usr/local/bin/youtube-dl

macOS 下的安装方法：

Linux 下的安装方法也适合 macOS ，也可以使用 brew 安装。

brew install youtube-dl ffmpeg

Windows 下的安装方法：

Windows 下的安装其实也很简单，下载 youtube-dl 和 ffmpge 的可执行文件，比如放到 D 盘，然后把可执行文件位置添加到环境变量，添加到 path 这个变量下。

添加到系统变量后，重启系统，进入 cmd 之后，输入 ffmpeg 和 youtube-dl 能跳出相应软件的操作提示即说明安装成功。

youtube-dl的常见用法

视频相关

默认情况下，youtube-dl会自动选择一个视频，但是这个视频不一定是质量最好的，我们可以自己选择需要下载的视频。

因为 YouTube 采用了音视频分离的方式，如果安装了 ffmpeg，youtube-dl 会下载质量最好的视频和音频进行合并。

-F ：列出所有的音视频文件

-f 137,136,135 ：下载指定的文件，这里的137就是 -F 列表中的 format code

-f 135-137,248-250 ：下载指定的文件

-f bestvideo+bestaudio ：YouTube 高质量的视频是音视频分离的，如果安装了 ffmpeg ，下载完成会自动把高质量的音视频整合成在一起。也可以指定 bestvideo 的格式，如果没有，还可以指定第二种格式，比如 -f bestvideo[ext=mp4]/bestvideo[ext=webm]+bestaudio[ext=m4a]，没有 mp4 格式，下载 webm 格式。

youtube-dl --proxy socks5://127.0.0.1:1080 https://www.youtube.com/watch?v=0pdGhuAiViA -f 137+140

--playlist-start 11 ：下载播放列表的起始位置

--playlist-end 20 ：下载播放列表的结束位置

--playlist-items ITEM_SPEC：下载播放列表里特定的选集，比如 –playlist-items 1,3,5,7-10，就会下载1、3、5、7、8、9、10集。

youtube-dl https://www.youtube.com/playlist?list=PLd9hCvj34W5hIJ855osxqJ-fjgsmNB69n --playlist-start 11 --playlist-end 20

音频相关

youtube-dl 功能非常强大，可以直接用 -F 参数查看音频文件进行下载，可以把视频下载下来转换成音频，但需要安装 ffmpeg 。

-x, --extract-audio ：将视频文件转换为纯音频文件（需要安装 ffmpeg）

--audio-format FORMAT ：指定音频格式: “best”, “aac”, “flac”, “mp3”, “m4a”, “opus”, “vorbis”, 或者 “wav”，默认是“best”，可以和 -x 搭配使用

--embed-thumbnail ：给音频文件写入封面

字幕相关

--write-sub ：下载字幕文件

--write-auto-sub ：下载自动生成的字幕文件，仅支持 YouTube

--all-subs ：下载所有可用的字幕

--list-subs ：列出可下载的字幕

--sub-format FORMAT ：字幕格式，接受格式偏好，如：“srt”（指定格式）或者“ass/srt/vtt”（首选格式，没有ass就下载src，没有src就下载vtt）

--sub-lang LANGS ：要下载多种语言的字幕，可以用逗号分隔，先使用 –list-subs 表示可用的语言标签

--embed-subs ：把字幕合并到视频中，只支持 mp4、mkv 和 webm 格式的视频

只下载英文字幕，不下载视频：

youtube-dl https://www.youtube.com/watch?v=iK3VEF2woRY --sub-lang en --skip-download --write-sub

其他参数

-U ：升级 youtube-dl

--list-extractors ：查看 youtube-dl 支持的网站列表

--version ：查看 youtube-dl 的版本

--proxy URL ：设置代理，比如：–proxy socks5://127.0.0.1:1080

-a, --batch-file FILE ：从文件中获取需要下载的URL

-r, --limit-rate RATE ：下载限速（写法： 50K 或者 4.2M）

-R, --retries RETRIES ：重试次数 （默认10）， 也可以使用“infinite”

-u, --username USERNAME ：登录后下载，这是用户名

-p, --password PASSWORD ：设置账户登录密码，如果此选项未使用，youtube-dl将交互式地询问

--sleep-interval SECONDS ：在下载多个视频时，设置每个视频的下载间隔，单位为秒

--merge-output-format FORMAT ：在下载的时候，有的时候需要 ffmpeg 对视频和音频进行合并，可以定义合并后的视频格式，可以是 mkv 、mp4、ogg、webm 或者 flv。

配置文件

Linux 和 macOS 系统下，youtube-dl 的系统全局配置文件位于 /etc/youtube-dl.conf，用户配置命令位于 ~/.config/youtube-dl/config 。Windows 下用户配置命令位于 %APPDATA%\youtube-dl\config.txt 或者 C:\Users\<user name>\youtube-dl.conf，默认情况下配置文件是不存在的，需要自己创建。

我们可以把常用的配置写入这个文件，写法和命令行运行的时候一样，这样我们在命令行输入的时候就可以方便很多，比如把 --proxy socks5://127.0.0.1:1080 直接写在配置里，不用每次下载都输入。如果某次使用的时候不想用配置文件，可以使用 --ignore-config 参数取消配置文件，也可以使用 --config-location 改写配置文件的地址。

常见问题解决办法

1、出现 unable to download video data: HTTP Error 403: Forbidden 的解决办法。

首先，使用 youtube-dl -U 升级到最新版本；

然后运行 youtube-dl --rm-cache-dir 删除缓存即可。

2、出现 ERROR: Unable to extract uploader id; please report this issue on https://yt-dl.org/bug . Make sure you are using the latest version; type youtube-dl -U to update. Be sure to call youtube-dl with the –verbose flag and include its complete output. 的解决办法。

YouTube 在 2023 年 2 月 15 日左右调整了，使用 youtube-dl 都会出现这种错误，解决办法是使用 yt-dlp 代替 youtube-dl。目前 yt-dlp 已经更新，解决了该问题。

总结

在使用 youtube-dl 的时候，记得经常升级，因为一些视频网站会修改页面的布局或者代码，如果不及时升级，可能会解析不了部分数据导致视频下载不了。

扩展阅读：

youtube-dl-gui，一款图形化界面的 youtube-dl，支持 macOS、Windows 和 Linux。

ClipGrab，一款命令行下的 YouTube 视频下载工具。

ffmpeg, A complete, cross-platform solution to record, convert and stream audio and video.

4K Video Downloader, 4K Video Downloader is cross-platform, which allows downloading videos, playlists, channels and subtitles from YouTube, Facebook, Vimeo and other video sites in high quality.