spotDL 五步教程：把 Spotify 歌单免费下载到本地的完整指南
【免费下载链接】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
通勤地铁里，网络一断音乐就停了。收藏的歌单，里面的歌也可能随时下架。spotDL 是一款免费的 Spotify 下载工具，能把歌单、专辑和歌曲连同封面、元数据一起存成本地音频文件，随时离线播放。本文带你用 5 步走完全部流程。
1｜它是什么 🔍
spotDL 是一个开源的命令行工具。它从 Spotify 读取歌单、专辑和歌曲信息，再去 YouTube 等平台找到对应的音频，下载后把封面、歌词和元数据一并写入文件。适合想把歌单备份下来、离线收听、整理本地曲库的人。
| 能做什么 | 来源 |
|---|---|
| 歌曲、专辑、歌单信息与封面 | Spotify |
| 音频文件 | YouTube、YouTube Music 等 |
| 歌词 | Genius、Musixmatch 等 |
下载逻辑在spotdl/download/目录，音频源代码在spotdl/providers/audio/，想深入研究从这两处入手。
2｜五分钟上手 🚀
- 环境要求：Python 3.10 以上，安装时记得勾选"Add to PATH"。
pip install spotdl—— 用 pip 装上工具本体。spotdl --download-ffmpeg—— 让 spotDL 自动把转码音频所需的 FFmpeg 下载到它自己的目录，不用单独装。- 建议再跑
spotdl --download-deno—— 装 Deno 运行时，缺它部分视频下不下来。 spotdl --version—— 显示版本号，说明安装成功。
macOS 和 Linux 上把命令里的pip换成pip3。
3｜跟着任务用 🎧
下载一首歌
在 Spotify 里右键复制歌曲链接，然后执行：
spotdl download 歌曲链接
文件会存进命令所在目录。没有链接也行，直接搜：spotdl download 'The Weeknd - Blinding Lights'。
批量下载歌单
复制歌单链接，命令不变：
spotdl download 歌单链接
歌单里的歌会排队逐首处理。不习惯敲命令的话，可以开网页版：
spotdl web
浏览器打开 http://localhost:8800，直接搜索、点几下就能下载（网页版目前只支持单曲）。
4｜顺手的小设置 ⚙️
- 想把歌存到指定目录 → 直接在那个目录里运行命令，文件默认落在执行处。
- 想改文件命名规则 → 加
--output "{artist}/{album}/{title}.{output-ext}"。 - 想换输出格式 →
--format opus，也可以选 m4a、flac 等。 - 想压低码率省空间 →
--bitrate 96k；普通账号音源上限是 128kbps，转更高码率只会变大不会变清晰。 - 想让本地曲库跟着歌单更新 → 先
spotdl sync 歌单链接 --save-file 歌名.sync.spotdl建同步文件，以后跑spotdl sync 歌名.sync.spotdl，新歌补进来、删掉的会移除。 - 想一次看完所有可调项 →
spotdl --generate-config生成 config.json。
5｜踩坑速查 🛠️
提示 "spotdl" 不是内部命令 / command not found处理：Python 的 PATH 没配好，重新安装并勾选 Add to PATH，或改用python -m spotdl运行。
报 YT-DLP download error，部分歌曲下不动处理：缺 Deno 运行时，执行spotdl --download-deno补装。
出现 HTTP Error 404处理：pip install -U spotdl升级到最新版，新版本已内置规避方案。
音质始终上不去处理：普通账号源质量上限 128kbps；有 YouTube Music Premium 的话，用--cookie-file带上账号 cookies 可拿到 256kbps。
写在最后
spotDL 把在线歌单变成硬盘里的音频文件，网络波动和曲库调整都影响不到你。想看源码或参与开发，先获取项目：
git clone https://gitcode.com/GitHub_Trending/sp/spotify-downloader
一句话提醒：只下载你有权使用的内容，尊重版权，遵守当地法律与平台规则。
【免费下载链接】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），仅供参考
