本地音乐

瓜子音乐可以扫描你电脑上已有的音乐文件，将它们导入到应用中统一管理和播放。本地音乐不需要在线播放插件，离线也能用。

支持的音频格式

分类	格式
可播放	MP3、FLAC、WAV、OGG、AAC、M4A、OPUS、AIFF
可扫描（暂不支持播放）	WMA、APE、WV、DSF、DFF

无损格式

FLAC、WAV、AIFF 为无损格式，音质最佳但文件较大。OPUS 在低码率下表现优秀，适合语音类内容。

添加本地音乐

方法一：添加扫描路径

1. 点击左侧导航 本地音乐
2. 点击页面右上方 添加目录 按钮
3. 选择你存放音乐文件的文件夹
4. 瓜子音乐会自动扫描该文件夹内的所有音频文件

你可以添加多个文件夹路径，支持一次性扫描电脑上不同位置的音乐文件。

方法二：过滤短音频

如果文件夹中存在大量短音频（音效、铃声、系统提示音等），可以在 本地音乐 页面设置最小时长过滤，低于该时长的文件不会被导入。

推荐设置

将最小时长设为 30 秒或 60 秒，可以过滤掉大部分非音乐短音频，保持曲库整洁。

自动匹配信息

扫描完成后，瓜子音乐会自动尝试补齐以下信息：

• 封面：从文件内嵌标签（如 ID3 的 APIC 帧）提取专辑封面，没有的通过网络匹配
• 歌词：优先读取文件内嵌歌词，其次搜索匹配同名 .lrc 歌词文件，最后通过网络获取
• 歌曲信息：读取文件标签中的歌名、艺术家、专辑、发行年份等信息

匹配过程在后台异步进行，扫描完成后即可开始播放，无需等待匹配全部完成。

本地歌曲管理

扫描导入的歌曲显示在本地音乐列表中，你可以：

• 使用 排序下拉菜单 按修改时间、歌曲时长、文件大小排序（再次点击切换升降序）
• 使用 分组下拉菜单 按 全部 / 歌手 / 专辑 分组浏览
• 拖拽排序：在「全部」视图的「默认排序」模式下，拖拽歌曲行即可自定义排列顺序
• 右键删除不需要的歌曲（仅从曲库移除，不删除文件）
• 将本地歌曲添加到歌单中
• 收藏到「我喜欢的音乐」
• 一键播放全部或随机播放

拖拽排序

拖拽时行仅支持上下移动，不会左右偏移。大数据量列表已做渲染优化，流畅不卡顿。

本地文件夹转歌单

在 本地音乐 页面，每个扫描目录都有一个 存为歌单 按钮，可以将该目录下的所有歌曲一键创建为一个歌单。适合将「周杰伦专辑文件夹」「学习背景音乐文件夹」等整理为独立歌单。

与下载歌曲的关系

通过瓜子音乐 下载 的歌曲会自动保存到下载目录，并且该目录会被自动添加到本地音乐扫描路径中，下载完成的歌曲会同时出现在 本地音乐 页面。

常见问题

扫描不到歌曲？

• 确认文件格式在支持列表中（8 种可播放格式）
• 确认文件不在时长过滤范围之外
• 确认文件夹路径有读取权限
• 尝试将音乐文件移到其他文件夹后重新添加
• 检查文件是否被加密或受 DRM 保护

封面或歌词没有匹配到？

• 确保歌曲文件的标签信息（歌名、艺术家）正确且完整
• 文件名包含「歌手 - 歌名」格式有助于提高匹配率
• 可以在播放时手动查看：如果在线有对应资源，播放时可以显示在线歌词
• 对于冷门歌曲，可手动放置同名 .lrc 歌词文件

本地歌曲数量显示不对？

• 删除的歌曲可能是逻辑删除（标记为缺失），不是物理删除文件
• 在本地音乐页面点击 重新扫描 即可更新状态
• 文件被移动或重命名后，原记录会失效，重新扫描会修复

扫描速度慢？

• 首次扫描大容量曲库（>10000 首）可能需要数分钟
• 扫描过程在后台进行，不影响其他操作
• 后续扫描仅检查新增和变更文件，速度大幅提升