10.5 GHz 开源相控阵雷达快速上手指南：3 条命令点亮你的雷达屏幕
2026/9/5 22:56:18
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-downloader
spotDL 是一款免费开源的 Spotify 下载工具：给它一个播放列表、专辑或单曲链接，它就把音频找出来、下好，再把歌手、专辑名、封面写进文件里。找 spotDL 中文教程的人，这篇就是完整清单——从安装、上手到排坑，一次讲清。
适合这几类人：
- 通勤、断网时想离线听歌
- 车机、老播放器不支持在线音乐
- 想拥有一份属于自己的音乐文件，不依赖 App
30 秒装好 spotDL 并下载第一首歌
最快路径分三步，装好就能出歌：
pip install spotdl安装本身就一条命令。装完先下第一首试试：
spotdl search 'The Weeknd - Blinding Lights'或者手里正好有 Spotify 链接，直接下载也行：
spotdl download https://open.spotify.com/track/0VjIjW4GlUZAZYd2vXMi3b文件会出现在你当前所在的目录。命令行觉得麻烦？spotdl web一下，浏览器里点按钮就能下，后文细说。
安装 spotDL：Python、预构建版、Docker 三选一
| 方式 | 特点 | 适合谁 |
|---|---|---|
| Python 包（pip） | 功能最全、更新最快，官方推荐 | 大多数用户 |
| 预构建可执行文件 | 不用装 Python，下载即用 | 电脑环境不想动的人 |
| Docker 容器 | 一条命令跑起来，环境干净 | 服务器或重度 Docker 用户 |
结论先给：普通用户选 Python 包。
用 Python 安装 spotDL（官方推荐）
先决条件：
- Python 3.10~3.14（安装时记得勾选 Add to PATH）
- FFmpeg 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 配置文件在哪里？
- Windows：
C:\Users\你的用户名\.spotdl\config.json - Linux：
~/.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），仅供参考