yt-dlp：功能最强大的开源视频下载工具，支持上千网站

# yt-dlp：功能最强大的视频下载工具

## 项目介绍

yt-dlp 是一款功能丰富的命令行音视频下载器，支持从 YouTube、哔哩哔哩、抖音、Vimeo 等数千个网站下载视频和音频。它是 youtube-dl 的活跃分支，由社区维护增加了大量新功能和错误修复，目前 GitHub 星标已突破 15.6 万，是视频下载领域的标杆工具。

## 核心特色

– **支持网站众多**：覆盖全球数千个视频网站，常见的主流平台几乎全部支持
– **下载速度快**：支持多线程下载，可同时下载多个视频片段
– **格式丰富**：支持下载为各种视频格式（MP4、WebM 等）和音频格式（MP3、Flac 等）
– **字幕下载**：自动下载视频字幕，支持嵌入式和外挂字幕格式
– **画质选择**：可选择下载特定画质（1080P、4K 等）或仅下载音频
– **元数据保留**：支持嵌入视频元数据、缩略图到最终文件中
– **SponsorBlock**：内置 SponsorBlock 功能，自动跳过视频中的广告段落
– **持续更新**：社区活跃，问题修复及时，新平台支持速度快

## 安装步骤

### Windows 系统

**方法一：下载可执行文件**

1. 访问 GitHub releases 页面下载 `yt-dlp.exe`
2. 将文件放到任意目录（如 `C:\Tools`）
3. 将该目录添加到系统 PATH 环境变量
4. 打开命令行即可使用

**方法二：使用 pip 安装**

“`powershell
pip install yt-dlp
“`

### macOS 系统

“`bash
# 使用 Homebrew 安装
brew install yt-dlp
“`

### Linux 系统

“`bash
# 使用 pip 安装
pip install yt-dlp

# 或下载二进制文件
curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o ~/.local/bin/yt-dlp
chmod +x ~/.local/bin/yt-dlp
“`

## 常用命令

### 基本下载

“`bash
# 下载普通视频
yt-dlp https://www.youtube.com/watch?v=视频ID

# 下载为 MP3 音频
yt-dlp -x –audio-format mp3 https://视频链接

# 选择画质（1080P）
yt-dlp -f “best[height<=1080]" https://视频链接 # 下载播放列表 yt-dlp --playlist-start 1 --playlist-end 10 https://播放列表链接 ``` ### 高级用法 ```bash # 下载并嵌入字幕（自动字幕） yt-dlp --embed-subs --字幕语言 zh-Hans https://视频链接 # 下载并嵌入缩略图 yt-dlp --embed-thumbnail https://视频链接 # 使用 SponsorBlock 跳过广告 yt-dlp --sponsorblock-remove sponsor https://视频链接 # 下载所有画质选项并合并 yt-dlp -f bestvideo+bestaudio https://视频链接 # 输出到指定文件夹 yt-dlp -o "~/Videos/%(title)s.%(ext)s" https://视频链接 # 限制下载速度（防止占满带宽） yt-dlp -r 1M https://视频链接 ``` ### 代理设置 ```bash # 使用代理下载 yt-dlp --proxy http://代理服务器:端口 https://视频链接 # 使用 SOCKS5 代理 yt-dlp --proxy socks5://代理服务器:端口 https://视频链接 ``` ## 适用场景 1. **下载学习资料**：下载哔哩哔哩、Coursera 等平台的课程视频 2. **离线观看**：下载电影、纪录片到本地观看 3. **音频提取**：将 MV 音乐下载为 MP3 4. **备份收藏**：下载重要视频进行本地备份 5. **自媒体素材**：下载无版权视频素材用于二次创作 ## 常见问题处理 ### 下载失败怎么办？ 1. 更新到最新版本：`yt-dlp -U` 2. 清除缓存：`yt-dlp --cookies-from-browser chrome --rm-cache-dir` 3. 添加 `--no-check-certificates` 参数忽略证书错误 ### 下载哔哩哔哩需要登录？ 部分需要大会员的画质需要登录 cookies，可使用浏览器扩展导出 cookies 后通过 `--cookies` 参数使用。 ## 开源协议 The Unlicense（公共领域） --- **服务支持**：如有兴趣不会搭建，可以联系微信：WRYD6166，开源项目搭建10-50元。