yt-dlp 三种更新源 Stable Nightly Master 选哪个
为什么要关注 yt-dlp 版本
yt-dlp 是 YTDLnis 的心脏,而 yt-dlp 自己的维护节奏很快——目标网站(YouTube、B 站、TikTok 等)经常改版防爬策略,yt-dlp 要跟着改才能继续工作。如果你的 yt-dlp 版本太旧,下载时可能报:
- Extractor 错误(
ERROR: youtube: Failed to extract ...) - 格式列表为空
- 下载完成但文件损坏
这些场景第一件事就是更新 yt-dlp。
三种更新源
「更多 → 设置 → Updating → yt-dlp Source」里选:
| 源 | 适合谁 | 说明 |
|---|---|---|
| Stable(默认) | 不太依赖的普通用户 | 最稳定但更新最慢,重大修复可能落后几周 |
| Nightly | 推荐,绝大多数用户 | 日更版,平衡稳定性和时效性,包含 Stable 没有的大部分修复 |
| Master | 高级用户 / 必须用最新修复的 | 每次提交都构建,修复最快但也最容易引入新 Bug |
| Custom | 有特殊需求的 | 填一个自定义的 yt-dlp 仓库 fork |
推荐选 Nightly——Stable 太慢经常跟不上网站改版、Master 太激进偶尔出问题。Nightly 是官方也推荐的主力源。
自动更新
Updating 设置里还有:
- Check for updates automatically — YTDLnis 定期(约每 24 小时)检查新版 yt-dlp,有就弹通知提示更新
- Update on startup — 每次打开应用都检查一次(更及时但费点流量)
一般开自动检查就够了,不用开启动时更新。
手动更新
两种方式:
- 终端命令:打开内置终端 →
yt-dlp -U,等它跑完就行 - 设置页面:「更多 → 设置 → Updating → yt-dlp Source」旁边有「Check now」按钮
终端更新可以在里面看到更详细的日志输出,包括下载了什么版本、更新了哪些内容。
某些地区更新不了
如果在中国大陆或部分网络受限地区,从 GitHub 拉取 yt-dlp 可能会被墙导致更新失败。表现是通知了有新版但下载卡住、或者 Updating 页面显示网络错误。
解决方案:
- 切换到 Nightly 源试试(有时 Stable 和 Nightly 的分发节点不同)
- 用终端手动更新时配合代理(终端里 yt-dlp 会继承系统代理设置)
- 换一个网络环境更新一次后就不用再管了(更新源保持 Nightly,自动更新在下次可用网络时继续)