企业官网建设流程全解析

Sunnify 是一款免费、开源的Spotify 下载器（Spotify playlist downloader），支持 macOS、Windows 和 Linux 三大平台。粘贴播放列表、专辑或单曲链接，它就能把整张歌单保存为带封面和音乐标签的本地 MP3、M4A、FLAC 等音频文件——不需要 Spotify 账号、不需要 API Key，FFmpeg 也已内置，开箱即用。本文将带你用一条命令完成三平台的 Sunnify 安装部署。

Sunnify Spotify 下载器功能总览：下载播放列表、专辑、单曲并写入封面与标签

一、安装前准备：零依赖，30 秒开始

Sunnify 的官方安装包做了充分的"减负"，普通用户几乎不需要任何前置准备：

• ✅无需任何账号：不需要登录 Spotify，也不需要配置 API Key
• ✅FFmpeg 已内置：转码所需的 FFmpeg 直接打包在应用里，不用单独安装
• ✅无需管理员权限：安装脚本全程运行在用户目录下，不弹 sudo / UAC 提示
• ⏳唯一的网络要求：能正常访问网络即可，下载与转码都在本机完成

💡 只有"从源码运行"这一种进阶用法需要 Python 3.10+ 环境，详见第五节。

二、macOS / Linux 一键安装步骤

macOS（Apple Silicon / Intel 均可）和 Linux 共用同一个安装脚本 scripts/install.sh。把仓库克隆下来后，一条命令即可完成部署：

git clone https://gitcode.com/gh_mirrors/su/sunnify-spotify-downloader && cd sunnify-spotify-downloader && sh scripts/install.sh

脚本执行过程中会自动完成以下工作：

1. 识别你的系统架构（macOS 的 arm64/x86_64、Linux 的 x86_64）并拉取对应的最新发布包
2. 用 SHA256 校验文件完整性（校验机制详见 SECURITY.md）
3. 完成安装并配好sunnify命令行

🍺macOS 补充：如果你习惯 Homebrew，也可以用 Cask 安装——仓库内置的 Casks/sunnify.rb 会自动选择对应架构版本、校验下载文件并清理隔离属性，同样无需额外配置。

如果脚本提示~/.local/bin不在 PATH 中，把下面这行加入你的 shell 配置文件（如~/.bashrc或~/.zshrc）：

export PATH="$HOME/.local/bin:$PATH"

三、Windows 一键安装步骤

Windows 版本使用 PowerShell 安装脚本 scripts/install.ps1。克隆仓库后，一条命令完成部署：

git clone https://gitcode.com/gh_mirrors/su/sunnify-spotify-downloader; cd sunnify-spotify-downloader; powershell -ExecutionPolicy Bypass -File scripts\install.ps1

脚本会自动完成：下载最新发布的 Windows 版 → SHA256 校验 → 安装到%LOCALAPPDATA%\Sunnify→ 把该目录加入用户级 PATH（无需管理员权限）。

⚠️ PATH 写入后，已打开的终端窗口不会立即生效，请新开一个 PowerShell 或 CMD 窗口再输入sunnify。

另外，官方发布的Sunnify-Windows.exe也可以双击直接运行，完全免安装，适合只想先试试看的用户。

四、验证安装结果：sunnify doctor 自检

安装完成后，建议花 10 秒验证一下环境是否就绪。每个 Sunnify 二进制都自带无窗口 CLI（完整命令参考 docs/CLI.md）：

sunnify --version # 查看版本号 sunnify doctor # 自检：FFmpeg、配置、网络连通性、版本新旧 sunnify --help # 查看全部命令

doctor命令会逐项检查 FFmpeg 是否可用、配置文件是否正常、Spotify 页面是否可达等，全部通过就可以放心使用了。

日常使用非常简单，四步搞定：

1. 复制一个 Spotify 播放列表 / 专辑 / 单曲链接
2. 粘贴进 Sunnify
3. 在设置里选择格式（MP3、M4A、Opus、FLAC、WAV）和音质
4. 点击 Download，边下边看进度，随时可停止

Sunnify Spotify 下载器桌面界面演示：粘贴链接后逐曲下载并写入标签

命令行同样支持全部功能，比如：

sunnify download "https://open.spotify.com/playlist/..." # 下载播放列表 sunnify info "<url>" --json # 只获取元数据

五、从源码运行（进阶，可选）

如果你是开发者，想直接运行源码，需要Python 3.10+（FFmpeg 预编译版已内置，源码运行则需系统里可找到 FFmpeg）：

git clone https://gitcode.com/gh_mirrors/su/sunnify-spotify-downloader cd sunnify-spotify-downloader pip install -r req.txt python Spotify_Downloader.py

依赖清单见 req.txt，主程序入口为 Spotify_Downloader.py。打包独立应用可参考 Sunnify.spec（PyInstaller 配置）。

六、安装失败？3 个常见问题排查

🔄 更新也很简单：直接重跑一次安装命令即可，两个脚本都是幂等的，会就地替换旧版本。

七、合法使用提醒

Sunnify 是一个教育性质的技术演示项目，请仅下载你拥有版权或已获得授权的内容，并遵守所在地区的法律法规。完整的法律条款见 DISCLAIMER.md。

小结：Sunnify 通过 scripts/install.sh（macOS/Linux）和 scripts/install.ps1（Windows）实现了真正的"克隆 + 一条命令"安装——自动识别架构、校验完整性、零管理员权限。现在打开终端，把上面对应平台的命令复制粘贴，你的 Spotify 下载器就已部署完成 🎧