视频下载

使用 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

质量预设

输出模板变量

-o 模板中的常用变量：

提示

• 始终使用 --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 会定期发布修复。