视频下载
使用 yt-dlp 直接从 URL 下载视频和音频,无需任何包装脚本。
前提条件
- yt-dlp:
brew install yt-dlp或pip install yt-dlp - ffmpeg:
brew install ffmpeg或apt install ffmpeg(合并视频+音频流时需要)
定期更新 yt-dlp 以应对网站变化:yt-dlp -U 或 pip install -U yt-dlp。
命令
下载最佳质量
yt-dlp "URL" -o "%(title)s.%(ext)s" --merge-output-format mp4
下载指定分辨率
# 720p
yt-dlp "URL" -f "bestvideo[height<=720]+bestaudio/best[height<=720]" --merge-output-format mp4
# 1080p
yt-dlp "URL" -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" --merge-output-format mp4
仅音频
yt-dlp "URL" -x --audio-format mp3 --audio-quality 0
下载字幕
# 下载视频并附带英文字幕
yt-dlp "URL" --write-subs --sub-langs en --merge-output-format mp4
# 下载视频并附带多种语言字幕
yt-dlp "URL" --write-subs --sub-langs "en,es,fr" --merge-output-format mp4
# 仅下载字幕(不下载视频)
yt-dlp "URL" --write-subs --sub-langs en --skip-download
获取元数据(不下载)
yt-dlp "URL" --dump-json --no-download
列出可用格式
yt-dlp "URL" -F
指定输出目录
yt-dlp "URL" -o "./downloads/%(title)s.%(ext)s" --merge-output-format mp4
质量预设
| 质量 | 格式标志 |
|---|---|
| 最佳 | -f "bestvideo+bestaudio/best"(默认) |
| 1080p | -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" |
| 720p | -f "bestvideo[height<=720]+bestaudio/best[height<=720]" |
| 480p | -f "bestvideo[height<=480]+bestaudio/best[height<=480]" |
| 最差 | -f "worstvideo+worstaudio/worst" |
输出模板变量
用于 -o 模板的常见变量:
| 变量 | 描述 |
|---|---|
%(title)s | 视频标题 |
%(ext)s | 文件扩展名 |
%(id)s | 视频 ID |
%(uploader)s | 频道/上传者名称 |
%(upload_date)s | 上传日期(YYYYMMDD) |
%(duration)s | 时长(秒) |
%(resolution)s | 视频分辨率 |
提示
- 始终使用
--merge-output-format mp4以避免生成.webm或.mkv文件。 - 对于仅查询元数据,使用
--no-download配合--dump-json— 不会向磁盘写入任何文件。 - 如果下载因 HTTP 错误失败,首先更新 yt-dlp(
yt-dlp -U)。 - 当不需要完整分辨率时,使用
-f "bestvideo[height<=720]+bestaudio"以节省带宽。 - yt-dlp 自动处理速率限制和重试。
--dump-json输出包含title、duration、uploader、view_count、description、formats、subtitles等许多信息。
故障排除
- "yt-dlp: command not found":安装它(
pip install yt-dlp)并确保你的 PATH 包含 pip 的 bin 目录。 - "ffmpeg: command not found":安装 ffmpeg。没有它,当视频和音频是分开的流时(常见于 YouTube 的高清视频),下载会失败。
- 下载失败或返回错误:运行
yt-dlp -U进行更新。网站变化频繁,yt-dlp 会定期发布修复。