Folia 本地歌单3 种创建方式、M3U8 导入导出与 5 个避坑点【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFoliafolia-major是以歌词动画见长的本地音乐播放器它的本地歌单只保存歌曲引用、不搬动磁盘音频。读完本文你能建单、调序、收藏并完成 M3U8 导入导出的完整流程。一句话定义Folia 本地歌单是什么本地歌单是 Folia 帮你维护的一张想听的歌清单只记录清单里有哪些歌不复制也不移动任何音频文件。核心设计原则是存引用、不动文件建单、调序、删单都可回退磁盘上的音乐始终不受影响。开始之前前置条件与准备先导入音乐文件夹在本地音乐区点导入文件夹等扫描完成歌曲进了曲库才能建单和匹配。只有本地歌曲参与歌单在线歌曲没有磁盘路径不属于本地歌单体系。建议用桌面版或支持 File System Access API 的浏览器Web 版导入文件夹依赖该能力。无需额外安装歌单数据存在本地数据库不会上传。五分钟上手从 0 到 1 把队列存成本地歌单打开底部播放区的队列面板确认当前队列里的歌曲是你想留的。点面板右上角的保存为歌单按钮队列全部为本地歌曲时才会出现该按钮。在弹窗里输入歌单名称并确认。本地音乐区出现新歌单歌曲顺序与队列完全一致。完成后你还可以打开歌单卡片、进入编辑模式拖动歌曲顺序会立即写回本地数据库下次打开 Folia 仍是你最后一次调整的样子。全部操作详解创建、管理与 M3U8 交换创建3 种建单方式从选中的歌曲新建入口本地音乐区选中歌曲后点新建歌单。步骤选中歌曲 → 点新建歌单 → 输入名称 → 确认。结果新歌单出现在首页包含你选中的歌曲重复添加会被自动拦截。队列固化为歌单入口队列面板右上角保存为歌单按钮。步骤打开队列面板 → 移除不想要的歌曲 → 点保存为歌单 → 输入名称并确认。结果生成一张与当前队列顺序完全一致的歌单队列里混有在线歌曲时该入口不可用。心形收藏到 Liked Songs入口播放区的心形按钮。步骤播放某首歌 → 点心形按钮 → 歌曲写入内置的 Liked Songs 收藏歌单再点一次即取消。结果收藏与取消都可以重复操作同一首歌不会进清单两次。管理调序、改名与删除调整歌曲顺序入口打开歌单卡片切换编辑模式卡片操作或命令面板中的toggle-edit-mode命令。步骤打开歌单卡片 → 进入编辑模式 → 拖动歌曲到新位置 → 退出。结果新顺序立即持久化到本地数据库无需手动保存。移除歌曲入口与调序相同的编辑模式。步骤进入编辑模式 → 选中要剔除的歌曲 → 确认移除。结果歌曲只从歌单中删除磁盘上的文件保持不变。重命名或删除歌单入口歌单卡片上的操作菜单实现位于 src/library/ 的集合操作层。步骤打开卡片操作菜单 → 选择重命名或删除 → 输入新名称或确认删除。结果状态即刻生效系统收藏歌单 Liked Songs 受保护删除入口在前端直接禁用后端也会拒绝。交换M3U8 导入导出步骤导出歌单为 M3U8入口歌单卡片操作或命令面板中的同名命令。步骤打开目标歌单卡片 → 在集合操作里选导出 M3U8 → 等待自动下载完成。结果得到以歌单名命名的.m3u8文件UTF-8 编码每首歌带时长与艺术家 - 标题信息行歌曲全部来自同一根目录时写入相对路径把文件放进该根目录即可直接播放跨多个根目录时保留根目录名放到它们的共同父目录即可。导入 .m3u / .m3u8 为歌单入口本地音乐首页的导入歌单按钮。步骤确认被引用文件夹已导入 Folia → 点导入歌单 → 选择.m3u或.m3u8文件 → 等待路径匹配完成。结果状态栏报出成功导入的歌数与跳过的路径数歌单名优先取文件内#PLAYLIST:注释行没有则用去掉扩展名的文件名。幕后原理本地歌单背后的 4 个设计细节只存歌曲 ID读取时清理引用歌单本质是一份歌曲 ID 列表每次读取时repairPlaylistSongIds会剔除指向已删除歌曲的条目并把重复导入的同一份文件合并到同一个正主 ID 上。对你有什么用清单里不会出现点不开的死链重复导入也不会产生两份记录。每次写入都过去重添加歌曲、保存队列、导入文件三条路径都先做一次去重。对你有什么用操作失误也不会让同一首歌进清单两次。导出时判断共享根目录导出前收集每首歌路径的第一段即导入根目录名恰好只有一个时才裁剪成相对路径否则写完整路径。对你有什么用导出的文件尽量保持可移植放到对应目录就能直接播。导入匹配宽容但不瞎猜file://地址、Windows 盘符、反斜杠、URL 编码会先归一成同一种比较形式普通网络 URL 不参与匹配一个路径命中多个候选时直接跳过。对你有什么用导入宁可少导几首也不会导错歌。避坑与 FAQ本地歌单 5 个常见问题问从曲库删掉文件夹或歌曲后歌单里会出现点不了的歌吗不会。失效引用在读取时就被剔除清单始终与曲库保持一致。问导出的 M3U8 换台设备能直接用吗前提是那台设备有同样的音乐文件且目录结构一致按共享根目录规则放置文件即可否则需手动改路径。问支持 foobar2000 的二进制 .fpl 歌单吗不支持Folia 只解析.m3u/.m3u8文本格式。问为什么 Liked Songs 删不掉它是系统收藏歌单前后端都拒绝删除你可以清空里面的歌曲但清单本身受保护。问导入时提示跳过了 N 条路径是什么意思两类情况都计入路径在曲库里找不到或同名文件有多个、无法确定指哪一个。补齐对应文件夹后重新导入即可。一页速查表本地歌单操作一览操作入口备注新建歌单本地音乐区选歌后新建歌单写入即去重保存队列为歌单队列面板右上角保存为歌单仅队列全为本地歌曲时可用收藏 / 取消收藏播放区心形按钮写入 Liked Songs可重复操作调整顺序 / 移除歌曲歌单卡片 → 编辑模式拖完即持久化重命名 / 删除歌单歌单卡片操作菜单Liked Songs 不可删除导出 M3U8歌单卡片操作 / 命令面板UTF-8自动下载相对路径优化导入 .m3u / .m3u8本地音乐首页导入歌单需先导入文件夹歧义路径跳过本地库的更多细节如.foliaignore排除规则、批量整理可查官方文档 docs/local-library-management.md歌单的存储、修复与文件解析逻辑集中在 src/services/。数据都在你自己机器上放心管理。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考