如何下载并运行 spotDL 预编译可执行文件（双击启动 Web UI / 终端运行 CLI）
【免费下载链接】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（项目路径GitHub_Trending/sp/spotify-downloader）是一个从 Spotify 歌单、专辑、艺人和歌曲链接出发，在 YouTube 上匹配音源并连同专辑封面、歌词和元数据一起下载的开源工具。除了推荐的pip install spotdl方式，官方还提供了一个预编译可执行文件（Prebuilt executable）：下载后不需要本机安装 Python，双击即可启动 Web UI，或在终端里以./spotdl-vX.X.X operation [urls]的形式运行 CLI。本文只覆盖这条预编译可执行文件路径：从 Releases 下载、准备依赖、启动 Web UI 或 CLI，并确认文件确实下载到了你期望的目录。
从 Releases 下载预编译可执行文件
安装指南 中 "Using Prebuilt Executable" 一节的说明是：
- 到项目的Releases Tab（发布页）下载最新版本的预编译可执行文件；
- 文档中 CLI 用法写作
./spotdl-vX.X.X operation [urls]，其中X.X.X是版本号占位符，实际执行时替换为你从 Releases 下载的文件名中的版本号。
下载完成后，把可执行文件放到一个固定目录（例如~/spotdl/），后续步骤都从该目录的终端执行。
准备 FFmpeg（必需）与 Deno（强烈推荐）
预编译可执行文件不需要 Python，但文档明确给出了两个随附命令，用于把依赖装到 spotDL 自己的目录里，而不是系统目录：
- FFmpeg：文档指出 FFmpeg 是 spotDL 必需的（FFmpeg 4.2 及以上）。如果 FFmpeg 只用于 spotDL，运行：
./spotdl-vX.X.X --download-ffmpeg该命令对应文档中的spotdl --download-ffmpeg，会把 FFmpeg 下载到 spotDL 安装目录，推荐优先使用这种方式而不是系统级安装。
- Deno：文档"强烈建议"安装 Deno。spotDL 通过 yt-dlp 从 YouTube 下载，部分视频（包括标记为 "made for kids" 的视频）必须有 Deno 才能下载成功；没有 Deno 时这些歌曲会失败。只给 spotDL 用 Deno 的话，运行：
./spotdl-vX.X.X --download-deno该命令对应文档中的spotdl --download-deno，把 Deno 装到 spotDL 目录。
双击启动 Web UI
文档说明：当命令行没有传任何参数时（例如直接双击可执行文件），Web UI 会默认启动。
关于 Web UI 的下载行为，使用文档 补充了两点：
- 默认情况下，Web UI 把文件下载到一个专用目录；
- 如果想让 Web UI 的输出目录跟随
--output参数，加--web-use-output-dir选项。文档同时提示：多个用户同时使用 web-ui 时，该选项"might cause issues"。
判断启动成功：双击后浏览器打开 Web UI 页面（与上图中展示的一致，即搜索框 + 下载列表的界面），即可直接在页面里搜索、下载歌曲。
在终端运行 CLI
在可执行文件所在目录打开终端（Windows 是 Command Prompt，macOS 是 Terminal，UNIX 是 Bash 或 Zsh），按文档格式运行：
./spotdl-vX.X.X operation [urls]spotdl-vX.X.X替换为你实际下载的文件名（X.X.X为版本号）；operation是 spotDL 的操作，默认操作是download（从 YouTube 下载歌曲并嵌入元数据）；[urls]替换为 Spotify 链接或搜索词。
查看当前构建支持的全部操作和选项：
./spotdl-vX.X.X -h（对应文档中的spotdl -h。）
一个可以直接照抄的示例——下载 使用示例 中给出的单曲：
./spotdl-vX.X.X download https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b也可以用引号包裹的搜索词替代 URL：
./spotdl-vX.X.X download 'The Weeknd - Blinding Lights'多个任务可以用空格排队执行，顺序无关：
./spotdl-vX.X.X download 'The Weeknd - Blinding Lights' https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID确认文件下载到了哪个目录
文档对"下载位置"的规则只有一条：spotDL 把文件下载到你运行 spotDL 的那个文件夹。因此想让歌曲落到指定目录，就要先在该目录里打开终端再执行：
- 通用做法：
cd到目标文件夹后运行上面的 CLI 命令； - Windows 快捷方式：在目标文件夹上按
SHIFT + 鼠标右键，选择 "Open PowerShell window here"，再在该窗口中运行命令。
执行download后，到当前目录检查是否出现了带元数据的音频文件，即为下载成功。
常见限制与排查
AudioProviderError: YT-DLP download error：故障排查文档 指出这通常是没装 Deno 导致的，解决方式是spotdl --download-deno（预编译可执行文件对应./spotdl-vX.X.X --download-deno）装一次即可。- Web UI 下载位置不符合预期：这是 Web UI 的默认行为（下载专用目录），不是错误；确需跟随
--output时才加--web-use-output-dir。 - 预编译可执行文件与
pip安装是两条独立路径：本文不包含pip环境下的 PATH 报错（如 "'spotdl' is not recognized"）排查，那些问题见 docs/troubleshooting.md。
更多操作（sync、save、音频格式与码率等）参考 docs/usage.md。
【免费下载链接】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），仅供参考
