yt-dlp 下载youtube音视频

By | 2025-10-31

在youtube上看到不错的资源想下载,往往要找各种在线下载器,但是广告太多,而且有时不可用,于是网上搜索发现了这个老牌的开源项目 yt-dlp

yt-dlp 是个命令行工具,算是 youtube-dl 的一个分支,但更新更活跃,支持更多的网站。它不依赖图形界面,用起来却意外地简单。


基本使用

如果你只是偶尔下载,可以直接通过命令行参数搞定。比如下面这个例子,可以从 YouTube 下载视频并转换为 mp3 音频:

yt-dlp --cookies-from-browser firefox -x --audio-format mp3 "https://www.youtube.com/watch?v=wGCHdoxR-cM"

这里用了几个参数:

  • --cookies-from-browser firefox 借用 Firefox 的登录状态,对付一些需要登录的内容比较有用
  • -x 提取音频
  • --audio-format mp3 指定输出为 mp3 格式
    image.png

进阶配置

要是经常使用,每次都敲一长串参数太麻烦。yt-dlp 支持配置文件,可以把你常用的设置都写进去。

配置文件放在这里:C:\Users\Administrator\AppData\Roaming\yt-dlp\config.txt

这是我的配置文件内容,供参考:

# 音频提取设置
-x
--audio-format=mp3
--audio-quality=320K

# 元数据和封面
--embed-metadata
--embed-thumbnail
--convert-thumbnails=png

# 输出路径和文件名
-o "d:\data\Music\%(uploader)s\%(title)s.%(ext)s"
--windows-filenames

# 网络和防检测
--cookies-from-browser=firefox
--sleep-interval=3
--max-sleep-interval=10
--user-agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"

# 下载设置
--no-overwrites
--continue
--no-part
--concurrent-fragments=5

# 播放列表设置
--match-filter="!is_live"
--no-playlist

# 错误处理
--no-warnings
--ignore-errors

简单解释几个关键设置:

  • 音频质量设成了 320K,追求音质可以这么设
  • 输出路径按上传者分文件夹,会自动整理得比较有序
  • 加了随机等待时间,避免请求太频繁
  • 过滤掉直播内容,只下载普通视频

配置好后,下载就变得特别简单:

yt-dlp.exe https://music.youtube.com/watch?v=54AN2Ikljfo&list=RDAMVMAp0huJwyT7g

只需要一个链接,所有设置都会自动应用。

使用提示

yt-dlp 本身是个绿色软件,不需要安装。在 Windows 下,下载好 .exe 文件,放在任意目录,然后在这个目录打开命令行就能用了。

如果遇到下载问题,通常更新到最新版本就能解决。yt-dlp 更新很频繁,对新兴网站的支持也比较好。

这个工具虽然看起来简单,但功能相当强大。支持上千个网站,各种自定义选项也很丰富。对于有媒体下载需求的人来说,算是个很实用的小工具。


我的快捷命令

@doskey yv=yt-dlp.exe --cookies-from-browser firefox -o "d:\data\Video\%%(uploader)s\%%(title)s.%%(ext)s" $*
@doskey ya=yt-dlp.exe --cookies-from-browser firefox -x --audio-format=mp3 --audio-quality=320K -o "d:\data\Music\%%(uploader)s\%%(title)s.%%(ext)s" $*

这样使用 yv 下载视频,ya下载音频