扫描不到歌曲怎么办：权限、文件与数据源的三级排查
排查总原则：从最常见的往下查
授权完成、扫描跑完，列表却空空如也——按下面的顺序查，绝大多数在第一、二级就解决。
第一级：权限还在吗
存储权限是硬前提，且可能被系统悄悄收回：
- 系统设置 → 应用 → 这款播放器（包名 com.kyant.vanilla）→ 权限，确认「音乐和音频/存储」为始终允许。
- 用过「仅这次允许」的，重启后权限失效，改回始终允许。
- 部分厂商省电策略会限制后台权限，把应用移出激进省电名单。
第二级：文件本身合格吗
- 是音频文件吗：扩展名与内容对得上（损坏文件、伪装扩展名扫不出）。
- 在手机存储里吗：确认文件真的在手机本地而非仅存在于网盘、电脑；外部存储卡的情况以设备支持为准。
- 目录特殊吗：极深的嵌套目录或应用私有目录可能不在扫描范围，把文件放进 Music 等常规目录再试。
第三级：手动触发重扫
权限与文件都正常，就手动跑一次重新扫描（设置 → 媒体库 → 扫描音乐），扫完按修改时间排序看列表头部有没有新条目。
情景对号入座
| 情景 | 最可能的原因 |
|---|---|
| 全新安装，列表全空 | 权限没给或没给全 |
| 之前正常，新拷的歌不见 | 需要手动重扫一次 |
| 部分歌在、部分不在 | 缺席文件在特殊目录或格式异常 |
| 改完文件后信息没变 | 数据缓存，重扫即清 |
仍不解决的出路
三级查完依旧空库，带着「系统版本 + 权限状态 + 文件位置截图」去反馈渠道求助；反馈前顺便过一遍安装问题确认版本正常。