spotDL 快速上手：Spotify 歌曲离线保存成 MP3，有多简单？
【免费下载链接】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 的歌曲、专辑、播放列表连同封面和元数据一起下成本地 MP3，之后离线随便听。
🎵 下载第一首 Spotify 歌曲成 MP3
先确认 Python 3.7 以上已加入 PATH，然后装 spotDL：
pip install spotdl看到Successfully installed就对了，macOS/Linux 换成pip3，不想装 Python 的话 Releases 里也有预构建可执行文件。
FFmpeg 负责转码和写封面，先补上它：
spotdl --download-ffmpeg它会把 FFmpeg 放进 spotDL 安装目录，不用你手动配。
再复制任意一首歌的 Spotify 链接，跑：
spotdl download https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b进度条走完，当前目录多出一个带封面、带元数据的 MP3。记住一个规则：文件存在你敲命令时所在的目录。
📁 整批离线保存歌单，还跟着自动同步
下载整个歌单，还是那句命令，换链接就行：
spotdl download https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID专辑、歌手同理；不想贴链接，直接搜歌名加引号：spotdl download 'The Weeknd - Blinding Lights'。多个目标用空格分隔排在一句命令里也可以。
想让本地文件跟着歌单走，先初始化同步生成记录文件：
spotdl sync https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID --save-file "my-list.sync.spotdl"目录里会多出my-list.sync.spotdl，记着歌单里每首歌，文件必须以 .spotdl 结尾。之后歌单有增删，重跑一次就自动补新删旧：
spotdl sync "my-list.sync.spotdl"只补不删的话，加--sync-without-deleting。
⚙️ 自定义文件名格式与音质
不想敲命令，可以开内置网页版：
spotdl web浏览器打开 http://localhost:8800，输入歌名搜索，点下载按钮即可，封面自动嵌入。
默认输出 128k MP3。想要更大文件，加--bitrate 320k；追求音质且是 YouTube Music Premium，加--cookie-file cookies.txt --format m4a --bitrate disable拿 256kbps 原码率。
改文件命名用--output，支持{title}、{album}、{track-number}等变量：
spotdl download [URL] --output "{artist} - {title} ({year}).{output-ext}"跑完文件就会变成"歌手 - 歌名 (年份).mp3"的样式。
🔧 卡住时去哪里找答案
文件去哪了？就存在敲命令的目录。Windows 在目标文件夹里按住 Shift 右键，选 "Open PowerShell window here"，再敲命令，文件就会落进这个文件夹。
command not found？多半是 PATH 没配对。在~/.bashrc或~/.zshrc末尾加export PATH=~/.local/bin:$PATH，再source一下。
某些歌总是下载失败？spotDL 用 yt-dlp 从 YouTube 取音频，部分视频需要 Deno，跑一次spotdl --download-deno即可。
想批量改配置？跑spotdl --generate-config生成配置文件：Windows 在C:\Users\用户名\.spotdl\config.json，Linux 在~/.config/spotdl/config.json，会自动加载。
更多报错查 docs/troubleshooting.md，全部命令参数见 docs/usage.md。
现在打开终端，敲pip install spotdl。装好后再挑一条你常听的播放列表，粘进 download 命令，几分钟后离线歌单就躺在文件夹里了。
【免费下载链接】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），仅供参考
