这是一份yt-dlp 命令大全 + 示例，这样你遇到不同需求（下载视频 / 音频 / 播放列表 / 字幕 / 切片等）都能直接用。
📌 yt-dlp 常用命令大全
1. 基本下载
- 下载视频（最佳画质 + 音质）
yt-dlp "URL"
- 下载成指定文件名
yt-dlp -o "%(title)s.%(ext)s" "URL"
2. 下载音频
- 提取音频（默认 m4a）
yt-dlp -x "URL"
- 指定音频格式（mp3/wav/flac/opus 等）
yt-dlp -x --audio-format mp3 "URL"
- 指定音频质量（0=最佳，9=最差）
yt-dlp -x --audio-format mp3 --audio-quality 0 "URL"
3. 播放列表相关
- 下载整个播放列表
yt-dlp "播放列表URL"
- 只下载某一个视频（忽略播放列表）
yt-dlp --no-playlist "URL"
- 下载播放列表的某几集
yt-dlp --playlist-items 1,3,5 "URL" # 下载第1、3、5个
yt-dlp --playlist-items 1-10 "URL" # 下载前10个
4. 视频画质选择
- 下载最佳画质（默认）
yt-dlp -f bestvideo+bestaudio "URL"
- 指定分辨率（如 720p）
yt-dlp -f "bestvideo[height=720]+bestaudio" "URL"
- 仅下载音频流（不转格式）
yt-dlp -f bestaudio "URL"
5. 字幕
- 下载字幕（不下载视频）
yt-dlp --write-subs --skip-download "URL"
- 下载英文字幕
yt-dlp --write-subs --sub-lang en --skip-download "URL"
- 下载自动生成字幕
yt-dlp --write-auto-subs --sub-lang en --skip-download "URL"
- 字幕格式转换成 srt
yt-dlp --write-subs --sub-format srt "URL"
6. 文件输出与命名
- 指定保存目录
yt-dlp -o "~/Downloads/%(title)s.%(ext)s" "URL"
-
输出模板常用变量
%(title)s→ 视频标题%(id)s→ 视频ID%(uploader)s→ 上传者%(playlist_index)s→ 播放列表序号
7. 高级功能
- 只下载部分时长（需 ffmpeg）
yt-dlp --download-sections "*00:00:00-00:30:00" "URL" # 前30分钟
- 限制下载速度
yt-dlp --limit-rate 500K "URL"
- 断点续传（默认支持）
yt-dlp -c "URL"
- 模拟运行（不下载，只显示信息）
yt-dlp -F "URL"
- 选择具体格式
yt-dlp -f 251 "URL" # 先用 -F 查格式编号
📌 常见示例
🎧 下载 YouTube 视频为 mp3
yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=xxxx"
🎬 下载 720p mp4 视频
yt-dlp -f "bestvideo[height<=720]+bestaudio" --merge-output-format mp4 "URL"
📜 下载 TED 演讲字幕 + 音频
yt-dlp -x --audio-format mp3 --write-subs --sub-lang en "URL"
⏱️ 只下载视频的前 1 小时音频
yt-dlp -x --audio-format mp3 --download-sections "*00:00:00-01:00:00" "URL"
👉 这些命令足够覆盖 90% 的使用场景了。
