Windows下载、安装yt-dlp-2026.07.04（附yt-dlp.exe）

发布于 2026/7/21 · 3 阅读
yt-dlp视频下载命令行工具YT下载开源软件Windows音视频SponsorBlockPython
yt-dlp 是全球最流行的命令行视频下载器，GitHub 163K+ 星标，支持 1800+ 网站。支持 SponsorBlock、多线程下载、浏览器 Cookie 提取等特性。

文章目录

封面.png

1. yt-dlp 简介

yt-dlp 是目前全球最流行的命令行视频下载器，GitHub 上已获得 超过 163,000 颗星标（Stars），拥有约 13,348 个分支（Forks），PyPI 月均下载量超过 1,200 万次。它支持从 1,800 多个网站下载音视频内容，包括 YT、Bilibili、IG、SoundCloud、X 等主流平台。

yt-dlp 诞生于 2020 年 10 月 26 日，并在 2021 年 1 月成为事实上的标准视频下载器。如今 Ubuntu 22.04 和 Debian bookworm 已默认用 yt-dlp。

核心维护团队包括 coletdjnz（插件架构、YT 改进）、bashonly（自动更新系统、安全修复）、Grub4K（自更新重写、并行下载进度）和 seproDev（用户体验优化）等多名活跃贡献者。项目采用 日历版本号（如 2026.07.04），大约每两周发布一个新版本，迭代速度极快。

yt-dlp 的核心优势：

  • SponsorBlock 集成：自动标记或跳过 YT 视频中的赞助片段、订阅提醒等非内容段落
  • 浏览器 Cookie 自动提取：一键从 Chrome、Firefox、Edge 等主流浏览器读取登录状态，无需手动配置
  • 多线程分片下载：通过 -N 参数并行下载流媒体分片，大幅提升下载速度
  • 按章节/时间范围下载：支持按视频章节分割文件，或仅下载指定时间段的片段
  • 格式排序系统：智能优先选择高分辨率、好编码的视频格式，可完全自定义排序规则
  • 灵活的插件架构：支持第三方提取器（Extractor）和后处理器（PostProcessor）插件
  • 自更新机制：yt-dlp -U 一键更新，支持 stable、nightly、master 三个发布频道

2. 2026.07.04 版本亮点

该版本汇集了 25 位贡献者 的 50 余条 贡献。

重要变更

  • 最低推荐 Python 版本提升至 3.11：由于 Python 3.10 将于 2026 年 10 月结束生命周期，现已提升最低推荐版本
  • Windows 二进制文件即将要求 Windows 10+：官方 Windows 发行版将很快不再支持 Windows 8/8.1
  • 安全修复 CVE-2026-55404：修复了 --write-link 选项中快捷方式文件的下游命令注入漏洞

平台支持更新

  • bilibili：修复 API 提取，恢复对 B 站视频的完整支持
  • IG：重构提取器，新增 Cookie 失效检测
  • YT：支持直播自适应格式（live adaptive formats），修复多项播放列表和元数据问题
  • niconico：新增短视频（Shorts）支持
  • soundcloud：新增评论提取功能，改进元数据提取
  • peertube：新增密码保护视频支持
  • 新增 omnyfm、zan、zoom clips 提取器

核心改进

  • 调试输出中始终包含警告信息，方便排查问题
  • parse_resolution 支持帧率后缀解析
  • random_user_agent 版本范围更新至 Chrome 144-150
  • 修复 aria2c 外部下载器的断点续传问题

3. 获取安装包

如果访问 GitHub 不便，安装包及中文文档：https://hanshuixin.org/go/2233（内含 yt-dlp.exe、README 中英对照、发布说明中英对照和 LICENSE）。

Windows安装yt-dlp-2026.07.04（yt-dlp）.zip
├── yt-dlp.exe   ← 可执行命令文件
├── 说明文档.pdf
├── README/
│   ├── README.md
│   └── README-中文版.md
├── 发布说明/
│   ├── RELEASE-NOTES.md
│   └── RELEASE-NOTES-中文版.md
└── LICENSE

附录：快速开始

yt-dlp 是命令行工具，将 yt-dlp.exe 放置在任意目录后，打开命令行（CMD 或 PowerShell）进入该目录即可使用。

推荐依赖：建议安装 ffmpeg 以获得完整功能（合并视频音频、后处理等）。将 ffmpeg.exe 放置在与 yt-dlp.exe 同一目录，或添加到系统 PATH 环境变量中即可自动识别。

常用命令

# 下载最佳画质视频
yt-dlp <视频URL>

# 下载最佳画质并指定输出目录和文件名
yt-dlp -o "~/Videos/%(title)s.%(ext)s" <视频URL>

# 仅下载最佳音频并转为 mp3
yt-dlp -x --audio-format mp3 <视频URL>

# 下载 1080p 最佳画质
yt-dlp -f "bv*[height<=1080]+ba/b" <视频URL>

# 查看所有可用格式
yt-dlp -F <视频URL>

# 批量下载（URL 列表写入文件，每行一个）
yt-dlp -a urls.txt

# 更新 yt-dlp 到最新版
yt-dlp -U

# 从浏览器提取 Cookie（用于需要登录的网站）
yt-dlp --cookies-from-browser chrome <视频URL>

# 下载播放列表
yt-dlp --playlist-start 1 --playlist-end 10 <播放列表URL>

# 仅下载指定时间范围（00:30 到 01:30）
yt-dlp --download-sections "*00:30-01:30" <视频URL>

# 限制下载速度（如 5M）
yt-dlp --limit-rate 5M <视频URL>