yt-dlp 安装与基础使用

前言

yt-dlp 是目前最强大的开源视频下载工具，支持 YouTube、Bilibili、Twitter 等 1000+ 网站。

本文介绍安装方法和最常用的下载命令，适合零基础用户。

一、安装 yt-dlp

方法1：pip 安装（推荐）

bash 复制代码

pip install yt-dlp

方法2：直接下载可执行文件（无需 Python）

Windows：下载 yt-dlp.exe，放入系统 PATH。

Linux/Mac：

bash 复制代码

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（合并音视频必需）

bash 复制代码

# Ubuntu/Debian
sudo apt install ffmpeg

# macOS
brew install ffmpeg

# Windows：下载后添加到 PATH

验证安装

bash 复制代码

yt-dlp --version

二、基础用法

1. 下载最高画质视频

bash 复制代码

yt-dlp -f "bestvideo+bestaudio/best" --merge-output-format mp4 "YouTube链接"

-f "bestvideo+bestaudio/best"：选择最高画质视频流 + 最高音质音频流合并
--merge-output-format mp4：输出为 mp4 格式（需要 ffmpeg）

2. 先查看有哪些可选画质

bash 复制代码

yt-dlp -F "YouTube链接"

输出示例：

复制代码

ID      EXT   RESOLUTION  FPS  FILESIZE
140     m4a   audio only       10.2MiB   （仅音频）
137     mp4   1920x1080   30   512.3MiB  （1080p视频，无音频）
248     webm  1920x1080   30   420.1MiB
22      mp4   1280x720    30   320.5MiB  （720p，音视频合并）

3. 指定画质下载

bash 复制代码

# 下载 1080p mp4 + 最佳音频
yt-dlp -f "137+140" --merge-output-format mp4 "YouTube链接"

4. 仅下载音频（MP3）

bash 复制代码

yt-dlp -x --audio-format mp3 --audio-quality 0 "YouTube链接"

-x：提取音频
--audio-format mp3：转换为 MP3
--audio-quality 0：最高质量（0最高，9最低）

5. 指定保存路径和文件名

bash 复制代码

yt-dlp -f "bestvideo+bestaudio/best" --merge-output-format mp4 \
  -o "/your/path/%(title)s.%(ext)s" \
  "YouTube链接"

常用文件名模板变量：

变量	含义
`%(title)s`	视频标题
`%(upload_date)s`	上传日期
`%(uploader)s`	频道名
`%(id)s`	视频 ID

三、常见问题

Q：下载时提示版本过旧怎么办？

bash 复制代码

pip install -U yt-dlp

Q：提示缺少 JS 运行时？

安装 Node.js 或忽略该警告，通常不影响下载。

Q：合并失败？

确认已安装 ffmpeg 并在系统 PATH 中。

小结

本篇介绍了 yt-dlp 的安装和基础下载命令。

下一篇将介绍：下载字幕、批量下载、配合 Python 脚本自动化，以及封装为 Claude Code Skill 一键调用。

下一篇：《yt-dlp 进阶：字幕、批量下载与 Claude Code Skill 封装》