Spotify 客户端为何臃肿

crmne/fastpotify 在 8 月底上线，不到两周从 0 涨到 1468 star，9 月 1 日 PR 合并加速后再次翻倍。它把 Spotify 官方桌面端 600MB-1GB 的常驻内存压到 100-250MB，单二进制 12MB，启动不到 1 秒。技术栈是 Rust + egui 做 UI、librespot 跑 Connect 协议层、projectM 做 MilkDrop 可视化——三件本来各做各的组件焊成了跨 Linux/macOS/Windows 的桌面应用。当前 release v0.4.1，README 写明要求 Rust 1.95+。Star 翻倍的窗口正好撞上社区讨论 Electron 应用瘦身、Spotify Web 端限速的热度。本文不夸它的 UI 美丑，只拆 cargo install 到能放歌之间最容易卡死的 5 个坑，全部基于实际 GitHub Issue 编号。

问题 1：cargo install 报 libclang.so 找不到

现象：Linux 上跑 cargo install --path .，编译到 libprojectM 时报错 failed to run custom build command for libprojectM，提示 cannot find libclang.so。

根因：libprojectM 走的是 build.rs 里的 bindgen，构建时要动态加载 libclang 解析 C 头文件。Arch/Debian 默认 clang 包不一定带 libclang.so 软链接。

解法（按发行版）：

# Arch
sudo pacman -S --needed cmake clang libxkbcommon wayland alsa-lib libpulse
# Debian / Ubuntu
sudo apt install libasound2-dev libpulse-dev libxkbcommon-dev \
  libwayland-dev cmake clang libclang-dev

不想搞可视化编译的：

cargo install --path . --no-default-features

这会跳过 MilkDrop，但播放、Spotify Connect、MPRIS 全部保留。Windows 用户需要 Visual Studio 2022、CMake、LLVM，再用 vcpkg install glew:x64-windows-static-md。NixOS 用户直接 nix develop 拉起全部工具链。

问题 2：tracks stuck on loading（Issue #139）

现象：v0.4.1 Windows 11 25H2 (OS Build 26200.9278) 用户点播放后永远卡在转圈，UI 显示 This item isn't available: spotify:track: ...。Reporter 是 Premium Individual 三个月试用账号，照样踩到。

根因：librespot 的本地播放凭证和 Web API 的 PKCE refresh token 是两套东西。前者存在 ~/.config/librespot/credentials.json，后者在 ~/.local/state/fastpotify/。没走「Set up playback here」那一步浏览器授权，UI 不报错，只是一直转圈。

解法：

# 1) fastpotify 里点 device 菜单的 "Set up playback here"
#    或 Settings → Account → Streaming
# 2) 浏览器拉起 Spotify 官方 streaming 授权页
# 3) 凭证写入 ~/.config/librespot/credentials.json
# 4) 重启 fastpotify，无需再次授权

注意：必须 Spotify Premium。Free 账号能浏览搜索，不能播放。如果 Issue #139 那种 「This item isn’t available」错误重现，先把 ~/.config/librespot/credentials.json 删了重新走授权流程。

问题 3：Winamp mini player 重开就死锁（Issue #141）

现象：v0.4.1 macOS 26.5.2 m5 MacBook Air 用户：放歌 → 开 mini player → 最小化 → 重新打开 mini player，整个 app 无响应，macOS 菜单栏也卡死。

根因：早期版本解析 .wsz 皮肤里的 zip 在主线程做 I/O，Winamp Skin Museum 上 10MB+ 的大皮肤会把 egui event loop 拖垮。

临时解法：

1. 先用 builtin 默认皮肤验证 mini player 不死锁。
2. 切第三方皮肤前 unzip -l skin.wsz 看下体积，超过 5MB 大概率触发。
3. 关掉 mini player 后从 system tray 重开主窗口测试。
4. Issue #141 跟踪中，等 v0.5 修复。生产环境先用 builtin 皮肤。

提交自己 .wsz 之前，README 里给出的 Winamp Skin Museum 链接是首选来源，但记得先 file skin.wsz 确认是 zip 容器。

问题 4：macOS 本地播放断断续续（Issue #140）

现象：macOS 26.5 Apple Silicon M5 上播放本地 AAC 流时频繁爆音，「like a radio going under a tunnel」。network 日志显示没掉包，session 没断。

根因：librespot 走 CoreAudio 默认 buffer，Apple Silicon 上默认 buffer size 偏小，被 macOS audio daemon 反复抢断采样周期。Issue 标题写了 distinct from #25，说明这是和另一个 session drop 不同的纯音频问题。

解法：

# 1) Audio MIDI Setup → 输出设备 buffer size 调到 512 samples
# 2) fastpotify 里 Settings → Audio → Backend 切到
#    "CoreAudio (low-latency)"
# 3) 仍有问题就建 Aggregate Device，把 librespot 重定向

9 月 1 日 commit 已经合并 #140 的 patch。Homebrew cask 用户 brew upgrade --cask crmne/tap/fastpotify 即可拉到。命令行控制的 fallback 路径：

fastpotify play-pause
fastpotify seek 15
fastpotify volume 40
fastpotify transfer <device-id>

这些 subcommand 跟运行中的实例通信，不起新进程。

问题 5：简体中文渲染尺寸不一（Issue #169）

现象：macOS 上含简体中文的标题（如 刘珂矣、半壶纱）字符大小和基线不一致，部分字符明显比其它小一号。

根因：系统字体 fallback 按名字排，Hiragino Sans（日文）声称自己是 “Sans” 而且能画 probe 字符 中，先被选中。但它不含简中独占字形（刘、壶、纱、纯、乐、寻、风…），这些字掉到下一个 fallback 的 Arial Unicode MS，em box 和 baseline 都对不上。这是 #10 的后续，#169 改成按 OS/2 表里的 legacy character set 排序，区域一致。

解法：

# macOS
brew install --cask font-noto-sans-cjk
brew install --cask font-noto-serif-cjk

# Arch
sudo pacman -S noto-fonts noto-fonts-cjk
# Debian / Ubuntu
sudo apt install fonts-noto fonts-noto-cjk
# Fedora
sudo dnf install google-noto-sans-cjk-fonts

装完从 tray 选 Quit 重启 fastpotify（不要 kill -9，否则凭证没刷盘），CJK 字就会按区域 fallback 一致渲染。Linux 上同样需要 noto-fonts，否则标题直接是空心方框（豆腐块）。

Sources

参考来源：GitHub Trending 2026-09-02、fastpotify 仓库 README、Issue #139（Windows 11 tracks stuck loading）、#140（macOS 26.5 M5 爆音）、#141（macOS 26.5.2 mini player 死锁）、#169（macOS CJK fallback）、r/ClaudeAI 中关于 Rust 重写桌面客户端的讨论。fastpotify.rocks 有官方安装、配置、每日使用指南。