3条命令完成 Spotify 歌单本地备份spotDL 快速上手指南【免费下载链接】spotify-downloaderDownload your Spotify playlists and songs along with album art and metadata (from YouTube if a match is found).项目地址: https://gitcode.com/GitHub_Trending/sp/spotify-downloaderspotDL 的定位一句话输入 Spotify 链接或歌手 - 歌名文本它去 YouTube 找到对应音频输出带封面、歌词和完整 ID3 标签的本地 MP3 文件。比如你有一份 50 首歌的 Spotify 播放列表跑一条命令后当前目录就会多出一份离线可播放、元数据齐全的音乐库。一、30 秒跑通第一条命令前提只有一个装了 Python 3.10–3.14 的机器安装时勾选 Add to PATH以及一条pip install spotdl。pip install spotdl装完补上它依赖的 FFmpeg 运行时下载到 spotDL 目录不污染系统环境spotdl --download-ffmpeg现在下载第一首歌换成任意 Spotify 单曲链接即可spotdl download https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b执行后文件落在你运行命令的当前目录——想让歌曲落到指定位置先cd过去再执行。官方 安装文档 里还有 Docker、Termux、预编译可执行文件等替代路径。二、核心能力拆解搜索与批量下载三种输入一个 download除了单曲链接spotdl download还接受三类查询一次可以传多个播放列表/专辑/歌手链接整张清单按序处理例如spotdl download https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID裸文本搜索spotdl download The Weeknd - Blinding Lights加引号防止 shell 解析下载自己的库spotdl download saved --user-auth拉取点赞过歌单all-user-playlists拉取全部自建歌单均需--user-auth走用户认证元数据嵌入下载完即入库每首歌曲完成后spotDL 自动抓取 Spotify 侧的专辑封面、艺术家、专辑名、流派与年份写入 ID3并生成.lrc歌词文件支持逐字同步时间轴。歌词来源走 lyrics providersGenius、AzLyrics 等抓不到歌词不影响音频下载只是少了这个附属文件。Web 界面不想敲命令就 spotdl webspotdl web默认监听http://localhost:8800浏览器里搜索、试听、下载适合在家庭机器上给非命令行用户使用。注意 Web 模式目前只支持单曲下载整列表任务仍走命令行文件默认存到一个独立目录加--web-use-output-dir可让它跟随--output。三、进阶用法同步文件与预加载sync让本地库跟着歌单走spotdl sync用一份.spotdl同步文件记录歌单快照之后每次运行只做增量——新增的歌下载被删的歌从本地移除其余不动spotdl sync https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID --save-file my-list.spotdl之后维护本地库只需spotdl sync my-list.spotdl加--sync-without-deleting则只补新不删旧。文件名必须以.spotdl结尾否则会报错。save preload先建清单后挑时间下载spotdl save [query] --save-file songs.spotdl --preload只把歌单解析成带下载地址的文件不实际下载。网络好的时候批量执行一次 save等带宽空闲了再逐条 download适合几百首歌的大歌单。四、常见坑与解决办法Q安装后提示spotdl is not recognized/command not foundPATH 问题。Windows 检查安装 Python 时是否勾选 Add to PATH安装文档里有截图对照Linux/macOS 把 pip 的用户 bin 目录加进 PATHexport PATH~/.local/bin:$PATH后source生效。Q报AudioProviderError: YT-DLP download error多半是缺 Deno——部分 YouTube 视频包括标记为 made for kids 的必须依赖它才能下载。执行spotdl --download-deno把 Deno 装进 spotDL 目录即可。Q遇到HTTP Error 404或RecursionError两者都是旧版本已知问题先升级再排查pip install -U spotdl。五、参数与数据一览项目默认值说明音频格式MP3兼容各播放器可选 M4A、OPUS--format码率128 kbps普通账户上限YouTube Music Premium --cookie-file可达 256 kbps建议 M4A/OPUS 并加--bitrate disable跳过转码Web 端口8800--port可改下载位置当前工作目录--output指定其他路径Python3.10–3.14低于此范围装不上依赖FFmpeg4.2音频转换必需命令行全选项—spotdl -h查看全部用法文档 还覆盖了meta重刷元数据、url只导出歌曲链接两个操作配置文件的固定位置也在其中。写在最后spotDL 适合把 Spotify 歌单固化成离线 MP3 的个人用户单人批量下载、元数据整理、Web 端轻度使用都能覆盖如果你需要的是无损母带或流媒体账号共享播放它不是对的工具。另外音频来源是 YouTube请只用于自己有权保存的内容版权责任由使用者自担。【免费下载链接】spotify-downloaderDownload your Spotify playlists and songs along with album art and metadata (from YouTube if a match is found).项目地址: https://gitcode.com/GitHub_Trending/sp/spotify-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考