命令大全-yt-dlp

这是一份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% 的使用场景了。