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.