下载神器yt-dlp使用教程

1. 安装 yt-dlp

Windows 系统

1. 下载工具

   • 访问 yt-dlp 官网 下载 yt-dlp.exe。
   • 将文件保存到 C:\Windows 目录（方便全局调用）或自定义路径（需配置环境变量）。

2. 安装 FFmpeg（可选但推荐）

   • 下载 FFmpeg，解压后将 ffmpeg.exe 和 ffprobe.exe 放入 C:\Windows。

macOS/Linux 系统

# 通过 curl 安装
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp

# 安装 FFmpeg
# macOS（需 Homebrew）
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

2. 基础使用命令

下载单个视频

yt-dlp "视频链接"

下载播放列表

yt-dlp "播放列表链接"

选择视频格式

# 列出所有可用格式
yt-dlp -F "视频链接"

# 下载指定格式（例如：视频137+音频140）
yt-dlp -f 137+140 "视频链接"

下载为 MP3 音频

yt-dlp -x --audio-format mp3 "视频链接"

3. 常用场景示例

下载最高画质视频

yt-dlp -f "bestvideo+bestaudio" --merge-output-format mp4 "视频链接"

批量下载频道或播放列表

# 下载整个 YouTube 频道
yt-dlp -f best "https://www.youtube.com/@频道名称"

# 限制下载数量（例如最新5个视频）
yt-dlp --playlist-end 5 "播放列表链接"

自定义保存路径和文件名

yt-dlp -o "~/Downloads/%(title)s.%(ext)s" "视频链接"

使用代理下载

yt-dlp --proxy "http://127.0.0.1:1080" "视频链接"

4. 进阶技巧

下载字幕

# 自动下载所有字幕（需视频提供字幕）
yt-dlp --write-subs --sub-langs en,zh-Hans "视频链接"

# 嵌入字幕到视频文件（仅支持 MP4/MKV）
yt-dlp --embed-subs "视频链接"

断点续传与限速

# 断点续传（默认已启用）
yt-dlp --continue "视频链接"

# 限制下载速度（例如 50KB/s）
yt-dlp --limit-rate 50K "视频链接"

绕过年龄限制

yt-dlp --cookies-from-browser chrome "需要年龄验证的视频链接"

5. 常见问题解决

报错「Unsupported URL」

• 原因：链接不合法或网站不受支持。

• 解决：更新 yt-dlp 到最新版本：

  yt-dlp -U

视频格式无法合并

• 原因：未安装 FFmpeg。
• 解决：确保已正确安装 FFmpeg 并配置环境变量。

下载速度慢

• 尝试更换格式（如 -f best 或指定低分辨率格式）。
• 使用 --proxy 参数切换网络代理。

6. 官方资源

• GitHub 仓库：https://github.com/yt-dlp/yt-dlp
• 完整文档：yt-dlp --help 或访问 文档页面