yt-dlp：视频下载命令行工具

为什么你需要 yt-dlp？

在日常工作中，我们经常遇到需要保存在线视频的场景：想收藏一个教学视频、需要离线观看纪录片、或者要提取视频中的音频片段。然而，多数网站不提供直接下载功能，或者通过浏览器插件下载的视频分辨率低、带水印，甚至无法解析。传统的下载方法往往受限于网站规则和格式限制，这让很多用户感到困扰。

yt-dlp 正是为解决这些问题而生的开源命令行工具。它是著名 youtube-dl 的活跃分支，持续更新以适配不断变化的网站结构，支持包括 YouTube、Bilibili、微博视频等在内的数千个平台。无论你是普通用户、内容创作者还是数据研究人员，它都能帮你轻松抓取到高质量的原始视频文件。

核心功能：远超视频下载

yt-dlp 不仅能下载视频，还提供了一系列实用特性，极大提升了获取效率。以下是最值得关注的几个要点：

• 多格式与清晰度选择：可列出所有可用格式，支持自定义分辨率、帧率、编码，甚至单独下载视频和音轨，再合并成无损的 MKV 或 MP4 文件。
• 复杂站点支持：内置大量站点提取器，能处理需要登录、年龄验证、播放列表或分 P 视频的页面，自动识别并批量下载。
• 灵活的抽取与转换：通过 ffmpeg 集成，能输出提取音频（mp3/m4a）、截图缩略图、嵌入字幕，并可对视频进行转码和裁剪。

安装：三步完成环境配置

yt-dlp 的使用环境要求非常简单：需要 Python 3.8 及以上版本（部分站点还需 ffmpeg 用于合并与转换）。安装方式依操作系统而异，但总体都很直接。

• Windows：推荐使用 pip 安装，打开命令提示符，执行 python -m pip install -U yt-dlp。若要方便调用，可将 Python 脚本目录加入 PATH。
• macOS/Linux：同样适用 pip 命令，或使用 Homebrew（brew install yt-dlp）。Debian/Ubuntu 也可用 apt 安装（但版本可能较旧）。

安装后，在终端输入 yt-dlp --version 检查是否成功。如果报错，请确认 Python 环境变量正确。

使用方法：从基础到进阶

yt-dlp 的基本用法很简单：在命令行中加上视频 URL 即可。

• 基础下载：yt-dlp "视频链接" 会下载默认最佳画质的视频。
• 列出所有格式：yt-dlp -F "视频链接" 查看全部可用格式代码，然后用 -f 参数选择，例如 -f 137+140 选择 1080p 视频和清晰音频。
• 提取音频：yt-dlp -x --audio-format mp3 "视频链接" 可直接获取 MP3 文件。
• 批量下载播放列表：直接把播放列表 URL 给 yt-dlp，它会自动处理所有视频，也可用 --playlist-start 和 --playlist-end 指定范围。

如果你需要登录才能访问的网站，可使用 --cookies-from-browser 参数读取浏览器 Cookie，绕过登录限制。更多参数可通过 --help 查看。

注意事项：合法合规使用

在使用 yt-dlp 时，请务必注意版权和网站服务条款。个人下载非商业用途的视频通常没问题，但最好不要下载受版权保护的内容用于公开传播。另外，部分网站有反爬机制，频繁请求可能导致 IP 被封，建议控制下载频率和并发数。最后，yt-dlp 更新频繁，如果遇到失效的站点，及时用 pip install -U yt-dlp 更新到最新版本。