文章目录1. yt-dlp 简介2. 2026.07.04 版本亮点重要变更平台支持更新核心改进3. 获取安装包附录快速开始常用命令1. yt-dlp 简介yt-dlp 是目前全球最流行的命令行视频下载器GitHub 上已获得超过 163,000 颗星标Stars拥有约 13,348 个分支ForksPyPI 月均下载量超过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、Safari 等主流浏览器读取登录状态无需手动配置多线程分片下载通过-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。macOS 用户不受影响yt-dlp_macos仍支持 macOS 10.15安全修复 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/2234内含 yt-dlp_macos、README 中英对照、发布说明中英对照和 LICENSE。macOS-通用安装yt-dlp-2026.07.04yt-dlp_macos.zip ├── yt-dlp_macos ├── 说明文档.pdf ├── README/ │ ├── README.md │ └── README-中文版.md ├── 发布说明/ │ ├── RELEASE-NOTES.md │ └── RELEASE-NOTES-中文版.md └── LICENSE附录快速开始yt-dlp_macos是适用于 macOS 10.15 的通用独立可执行文件Universal binary同时兼容 Intel 和 Apple SiliconM1/M2/M3/M4芯片无需额外安装 Python 或任何依赖。解压后在终端Terminal中进入解压目录先赋予可执行权限然后即可运行# 赋予执行权限仅首次需要chmodx yt-dlp_macos推荐依赖建议安装 ffmpeg 以获得完整功能合并视频音频、后处理等。可通过 Homebrew 安装brew install ffmpeg。如需完整 YT 支持推荐安装 JavaScript 运行时deno / node.js / bun可通过 Homebrew 安装brew install deno。常用命令# 下载最佳画质视频./yt-dlp_macos视频URL# 下载最佳画质并指定输出目录和文件名./yt-dlp_macos-o~/Movies/%(title)s.%(ext)s视频URL# 仅下载最佳音频并转为 mp3./yt-dlp_macos-x--audio-format mp3视频URL# 下载 1080p 最佳画质./yt-dlp_macos-fbv*[height1080]ba/b视频URL# 查看所有可用格式./yt-dlp_macos-F视频URL# 批量下载URL 列表写入文件每行一个./yt-dlp_macos-aurls.txt# 更新 yt-dlp 到最新版./yt-dlp_macos-U# 从浏览器提取 Cookie用于需要登录的网站./yt-dlp_macos --cookies-from-browser chrome视频URL# 下载播放列表./yt-dlp_macos --playlist-start1--playlist-end10播放列表URL# 仅下载指定时间范围00:30 到 01:30./yt-dlp_macos --download-sections*00:30-01:30视频URL# 限制下载速度如 5M./yt-dlp_macos --limit-rate 5M视频URL如需全局使用在任意目录下输入yt-dlp即可运行可将可执行文件移动到系统 PATH 目录sudomvyt-dlp_macos /usr/local/bin/yt-dlp
