alger music 中文文档 下载 App

歌词缓存:LRC 文件自动存储复用

歌词缓存是什么

AlgerMusicPlayer 从网易云接口拉取歌词(LRC 格式)后,会缓存一份到本地。下次播放同一首歌时直接读本地缓存,减少 API 请求。

默认位置

平台默认路径
Windows%APPDATA%/AlgerMusicPlayer/cache/lyrics/
macOS~/Library/Application Support/AlgerMusicPlayer/cache/lyrics/

每个文件是标准的 .lrc 格式,文件名通常用歌曲 ID + 哈希命名。

缓存生命周期

事件行为
第一次播放某歌从网易云拉歌词 → 缓存到本地
再次播放同一歌直接读缓存,不拉接口
网易云歌词有更新Alger 会定期检测 → 拉新覆盖旧缓存
手动清理缓存删除缓存文件,下次播放重新拉

清理方式

设置 → 缓存 → 歌词缓存 → 清理。可以单独清理歌词缓存而不动音乐缓存。

缓存与下载歌词的区别

维度缓存歌词下载歌词
生成原因播放时自动缓存下载歌曲时附带 .lrc
位置Alger 内部缓存目录下载目录,与歌曲同级
管理Alger 自动管你手动管理
格式内部命名标准同名 .lrc,可直接用文本编辑器打开

v5.1.0 歌词 IPC 修复

v5.1.0 修复了几个歌词相关的底层 bug:

这些都是开发者才能看懂的技术细节,但修复后用户体验更稳定——歌词窗口不会无缘无故消失、内存不会慢慢吃掉。