如何使用Pytube下载YouTube音乐播放列表的音频文件

前置准备 #

首先确保你的设备已安装Python 3.7+版本，随后执行以下命令安装Pytube工具：
pip install pytube

批量下载播放列表音频代码 #

直接使用以下现成代码即可实现需求，代码已做自动重命名为MP3、错误跳过处理：

from pytube import Playlist
import os

# 替换为你的YouTube播放列表公开链接
playlist_url = "替换为实际播放列表链接"
pl = Playlist(playlist_url)

# 自定义音频保存路径，默认保存在当前目录的youtube_music文件夹
save_path = "./youtube_music"
os.makedirs(save_path, exist_ok=True)

print(f"检测到播放列表共{len(pl.video_urls)}个内容，开始下载")
for video in pl.videos:
    try:
        # 仅筛选音频流，默认取当前视频最高比特率的音频
        audio_stream = video.streams.filter(only_audio=True).order_by('abr').desc().first()
        print(f"正在下载：{video.title}")
        out_file = audio_stream.download(output_path=save_path)
        # 自动将下载的音频文件修改为MP3后缀
        base, ext = os.path.splitext(out_file)
        new_file = base + '.mp3'
        os.rename(out_file, new_file)
        print(f"下载完成：{video.title}")
    except Exception as e:
        print(f"下载{video.title}失败，已自动跳过，错误：{str(e)}")
        continue

使用说明&注意事项 #

• 必须确保你的YouTube播放列表设置为公开状态，设置为私有的播放列表Pytube无法正常解析
• 若需要指定下载音频的比特率，可将筛选音频流的代码修改为 video.streams.filter(only_audio=True, abr="128kbps").first()，将128kbps替换为你需要的比特率即可
• 部分视频因地域限制、版权限制无法下载属于正常情况，代码会自动跳过继续下载后续内容

内容的提问来源于stack exchange，提问作者user3207874