spotDL 完整指南3 步把 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-downloaderspotDL 是一款免费开源的 Spotify 下载工具给它一个播放列表、专辑或单曲链接它就把音频找出来、下好再把歌手、专辑名、封面写进文件里。找 spotDL 中文教程的人这篇就是完整清单——从安装、上手到排坑一次讲清。适合这几类人通勤、断网时想离线听歌车机、老播放器不支持在线音乐想拥有一份属于自己的音乐文件不依赖 App30 秒装好 spotDL 并下载第一首歌最快路径分三步装好就能出歌pip install spotdl安装本身就一条命令。装完先下第一首试试spotdl search The Weeknd - Blinding Lights或者手里正好有 Spotify 链接直接下载也行spotdl download https://open.spotify.com/track/0VjIjW4GlUZAZYd2vXMi3b文件会出现在你当前所在的目录。命令行觉得麻烦spotdl web一下浏览器里点按钮就能下后文细说。安装 spotDLPython、预构建版、Docker 三选一方式特点适合谁Python 包pip功能最全、更新最快官方推荐大多数用户预构建可执行文件不用装 Python下载即用电脑环境不想动的人Docker 容器一条命令跑起来环境干净服务器或重度 Docker 用户结论先给普通用户选 Python 包。用 Python 安装 spotDL官方推荐先决条件Python 3.10~3.14安装时记得勾选 Add to PATHFFmpeg 4.2 以上Windows 额外需要 Visual C 2019 可再发行组件装完 spotDL 后FFmpeg 忘了装也别慌一条命令补上spotdl --download-ffmpegmacOS / Linux 用户把pip换成pip3即可。另外建议顺手执行spotdl --download-deno——个别视频如儿童向标记的需要 Deno 才能下成功。不想装 Python直接用预构建可执行文件从项目的 Releases 页面下载对应系统的最新版即可。双击就能打开 Web 界面想用命令行就在终端里运行./spotdl-vX.X.X download [Spotify链接]用 Docker 运行 spotDL 下载一行命令不碰本机环境docker run --rm -v $(pwd):/music spotdl/spotify-downloader download [Spotify链接]挂载的目录要可写不想手动管挂载用仓库里的 docker-compose.yml然后docker compose run --rm spotdl download [Spotify链接]文件会存进spotdl_music卷里。spotDL 两种用法Web 界面和命令行怎么选用 spotDL Web 界面下载不用记命令适合偶尔下几首、不想碰终端的场景spotdl web然后浏览器打开 http://localhost:8800界面长这样顶部搜索框输入歌名或粘贴 Spotify 链接点搜索再点歌曲右侧的绿色下载按钮完事。默认文件存在会话目录里想让它跟--output指定的目录走加--web-use-output-dir参数。用 spotDL 命令行下载批量和自动化场景适合成批下载、写脚本、服务器上跑spotdl download https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID单曲、专辑、播放列表、歌手主页同一句download都认不想给链接就搜索spotdl download 歌手 - 歌名多个任务空格隔开一次排队下载完spotDL 进阶能力清单同步、命名、音质按需取用让本地音乐库和 Spotify 播放列表保持同步播放列表加了新曲自动补上删掉的自动清理spotdl sync https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID --save-file my-playlist.sync.spotdl以后只需要同步一下即可不用重复贴链接spotdl sync my-playlist.sync.spotdl不想删本地旧文件加--sync-without-deleting。自定义 spotDL 下载文件命名格式默认是歌手 - 歌名.mp3。想按专辑年份归类改--output就行spotdl download [链接] --output {artist} - {title} ({year}).{output-ext}可用变量还有{album}、{track-number}、{year}等完整列表见 docs/usage.md。调整音质和格式默认输出 MP3、128kbps兼容性最好。想更高音质或换格式spotdl download [链接] --format m4a --bitrate 256k支持 mp3、m4a、opus、flac、wav 等。注意普通账号最高就是 128k拿不到源端更高的码率YouTube Music Premium 用户可以用--cookie-file cookies.txt--format m4a --bitrate disable拿到 256k 原声文件。把常用参数写进配置文件参数懒得每次敲配置一次长期生效spotdl --help里的选项基本都能在配置里设。生成模板spotdl --generate-configspotDL 常见问题排坑清单文件去哪了、配置在哪、卡住找谁下载的 spotDL 文件在哪里就在你运行命令时所在的目录。想存到指定文件夹先让终端站在那个文件夹里。Windows 老办法在目标文件夹按住Shift点右键选在此处打开 PowerShell 窗口再跑命令。spotDL 配置文件在哪里WindowsC:\Users\你的用户名\.spotdl\config.jsonLinux~/.config/spotdl/config.json文件存在就会被自动加载想关掉自动加载把配置里的load_config改成false即可。下载卡住或报错去哪求助先翻 docs/troubleshooting.md 和 docs/usage.md多数报错都有现成答案再不行去项目 Discord 社区问维护者和老用户都在里面。想自己看代码spotdl/console/ 是入口spotdl/providers/ 放音频和歌词源。下一步先把第一首歌存下来spotDL 干的就是这件事把 Spotify 里的歌变成你磁盘上带封面的 MP3。现在就去装一个下第一首歌顺手把sync和自定义命名试起来剩下的交给它跑。【免费下载链接】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），仅供参考