安装指南
五个平台各自的安装步骤、被系统拦住时的放行方法、命令行安装、官方包核对，以及装好之后的快速上手：怎么播放、怎么导歌单、怎么开歌词。卡在哪一步，直接看对应那段。
适用于 v5.1.2 还没下载？去下载页 →
一、按平台的安装步骤
先说你用的是哪个系统，再看那一段就行。
Windows
- 在下载页点 Windows 卡的「立即下载」，得到一个
.exe文件。 - 双击运行，按安装向导的提示走完。
- 如果弹出蓝色的「Windows 已保护你的电脑」，点更多信息 → 仍要运行。这是缺少商业代码签名的常规提示，不是病毒。
没有管理员权限的话，安装时可能会要求你输入管理员密码。
macOS
- 在下载页点 macOS 卡的「立即下载」，得到一个
.dmg文件（Intel 与 Apple Silicon 通用，不用挑）。 - 打开 DMG，把 Spotube 图标拖进「应用程序」文件夹。
- 首次打开如果提示「无法打开，因为无法验证开发者」，去「系统设置 → 隐私与安全性」，找到被拦截的提示，点仍要打开。
用 Homebrew 的话可以跳过上面三步：brew install --cask spotube
Linux
- 在下载页点 Linux 卡的「立即下载」跳到官方发布页，按发行版选包：Debian / Ubuntu 选
.deb，Fedora / openSUSE 选.rpm，拿不准就用.tar.xz通用包。 .deb/.rpm用发行版自带的图形包管理器或终端安装；.tar.xz解压后直接运行。- 用 AppImage 的话，先给它可执行权限再双击：
chmod +x Spotube-linux-x86_64.AppImage - 也可以直接用 Flatpak 版，已上架 Flathub：
flatpak install com.github.KRTirtho.Spotube
ARM 设备（aarch64）请在发布页选对应架构的包，装错了打不开。
Android
- 在下载页点 Android 卡的「立即下载」，得到一个
.apk文件（全架构通用，不用查手机型号）。 - 打开时系统会提示「已阻止安装未知应用」，去「设置 → 应用 → 特殊应用权限 → 安装未知应用」，为你下载文件时用的浏览器或文件管理器临时授权。
- 装完建议把那个临时授权关掉。
不想手动装 APK 的话，直接去 F-Droid ↗ 安装，国内通常更稳。
iOS / iPadOS
- 先在电脑或手机上装好 AltStore 或 Sideloadly 这类自签名工具 —— iOS 版没有 App Store 版本，只能侧载。
- 下载 IPA 文件，用上述工具配合你自己的 Apple ID 完成签名与安装。
- 安装后需要在「设置 → 通用 → VPN与设备管理」里信任对应的开发者证书。
- 免费证书约 7 天失效，到期应用会打不开，需要用同一方式重新签名。
详细步骤请以工具官方文档为准：AltStore 官方教程 ↗。侧载会绕过 App Store 审核，请自行评估风险。
二、被系统拦住怎么办
这四种是最常遇到的。共同原因只有一个：安装包没有购买商业代码签名，所以系统默认拦下来。
Windows：安装被拦截
弹出「Windows 已保护你的电脑」，只有「不运行」按钮
点「更多信息」→「仍要运行」。
macOS：打不开
提示「无法打开，因为无法验证开发者」
「系统设置 → 隐私与安全性」→ 找到该应用 → 点「仍要打开」。
Android：安装被阻止
提示「已阻止安装未知应用」
「设置 → 应用 → 特殊应用权限 → 安装未知应用」，为你下载文件时用的浏览器或文件管理器临时授权。
Linux：装了没反应
双击 .deb 无反应，或 AppImage 不能运行
.deb 请在终端里用发行版自带的包管理器安装；AppImage 需要先 chmod +x 赋予可执行权限再运行。
三、命令行安装
装过一次就会了：复制下面任意一条命令到终端或 PowerShell 执行。
winget install Spotubescoop install spotubechoco install spotubebrew install --cask spotubeflatpak install com.github.KRTirtho.Spotubehttps://f-droid.org/packages/oss.krtirtho.spotube四、怎么确认你下的是官方包
不用懂技术，核对三件事就够了。
Spotube- 开头，版本号与下载页显示的 v5.1.2 一致本站不修改、不重打包任何安装包。下载页的下载链接指向由 GitHub 官方 Release 同步而来的副本，内容与官方一致 —— 也就是说，你从这里拿到的，和从 GitHub 直接下载的是同一个文件。
五、装好之后怎么用
先说一个前提：Spotube 自己不带曲库，要装上插件才有歌可搜可播（插件怎么装在功能页讲）。配好之后，下面四件事就是新手最先要做的。
怎么播放音乐
打开 Spotube，从资料库或搜索里选中一首歌，点一下就开始播放。想找新歌就用搜索 —— 搜索走的是你装的插件指向的服务，那个服务上有什么，你就能搜到什么；搜不到先检查插件装好没有。
进度、音量、播放队列的控制都在本机完成，不受服务端限制。
怎么导入歌单
Spotube 提供歌单导入与同步的机制：可以从插件接入的服务导入歌单，也可以在本地新建、编辑、整理你自己的歌单。
注意：不保证每个服务的歌单都能导入成功，某个服务的歌单导不进来，是那个插件层面的限制，不是客户端坏了。
怎么开歌词
歌词不需要额外安装：播放页直接看，当前行高亮，跟着时间轴逐句滚动 —— 这就是时间同步歌词。
歌词来自公开歌词数据库，和你用的是哪个音源插件无关。数据库里没有那首歌的带时间轴歌词，就不显示，这不是故障。
怎么切换中文界面
界面语言支持中文：打开「设置」，找到语言（Language）选项，选简体中文即可切换。
改完语言后菜单和按钮会跟着变；个别地方如果还显示英文，是翻译还没覆盖到的位置，不影响使用。