Folia 音乐播放器新手教程：从曲库搜歌到全屏歌词动画的完整听歌流程
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是一款以全屏沉浸式歌词动画见长的音乐播放器，曲库同时覆盖本地音乐库、Navidrome 以及网易云、QQ 音乐、酷狗。这篇新手教程带你走完「选来源 → 搜歌 → 播放切歌 → 收藏 → 解锁进阶」的日常听歌闭环，几分钟就能把它当日常播放器用。
打开 Folia，先认齐三处入口
第一次打开 Folia 别急着找歌，先花十秒认齐三处，后面全程用得上。
| 区域 | 位置 | 干什么 |
|---|---|---|
| 来源页签 | 顶部中间 | 在Folder（本地）、Navi（Navidrome）、在线平台之间切换，等于切换「去哪儿搜」 |
| 搜索框 | 顶部右侧 | 输入歌名、歌手或专辑，直接出结果，占位文案跟着来源变 |
| 登录悬浮按钮 | 右下角 | 展开/收起网易云、QQ 音乐、酷狗等平台的登录入口 |
首页是一张「海报墙」：歌单、专辑、文件夹都以卡片铺开，点任意一张就进它的歌曲列表。来源页签决定曲库从哪儿来——本地、Navidrome 和在线平台互不干扰，切页签就等于换地方找歌。
| 曲库来源 | 页签显示 | 能干什么 |
|---|---|---|
| 本地音乐库 | Folder/ 本地 | 读取本地音频，自动补全歌词与封面 |
| Navidrome | Navi | 连接自己搭的流媒体服务器 |
| 网易云 / QQ 音乐 / 酷狗 | 在线平台页签 | 在线搜歌、歌单、收藏专辑 |
💡 顶部信息条支持键盘
Tab/Shift + Tab在歌单、电台、专辑、本地、Navidrome 之间循环切换，遥控器也能用。
认完入口，下一件正事就是找到想听的那首。
搜索歌曲的几种方式
最直接的当然是右上角搜索框。切到对应来源页签后，输入关键词，比如「周杰伦」，占位提示会自动变成搜索在线歌曲...、搜索本地歌曲...或搜索navidrome...（对应 搜索提示文案），在结果列表里点一首，就直达播放与全屏歌词页。
- 顶部页签选来源：
Folder（本地）、Navi（Navidrome）或在线平台； - 右上搜索框输入关键词，如「周杰伦」；
- 结果列表里点一首，进入播放与歌词页。
不想点页签？按S打开命令面板，直接输「搜索歌曲」「搜索本地歌曲」「搜索 Navidrome」等汉字或拼音就能触发，比鼠标点找更快（见 命令面板组件）。忘切页签也没关系，这条路能兜底。
💡 命令面板里同一句命令可以覆盖多个来源，手速快一点，找歌基本靠它。
歌找到了，接下来是把节奏握在自己手里。
不碰鼠标：播放与切歌的快捷键体系
进入播放页后，Folia 内置一套覆盖日常操作的键盘快捷键，完整定义见 播放页快捷键清单，手可以一直搁在键盘上。
| 操作 | Windows / Linux | macOS |
|---|---|---|
| 播放 / 暂停 | Space | Space |
| 上一首 / 下一首 | Ctrl + ←/Ctrl + → | Cmd + ←/Cmd + → |
| 快退 5 秒 / 快进 5 秒 | ←/→ | ←/→ |
| 打开命令面板 | S | S |
| 打开队列面板 | Ctrl + P | Cmd + P |
| 切换右侧面板 | P | P |
| 收起 / 显示界面 | H | H |
| 浏览器全屏 | F11 | F11 |
除了键盘，进度条标题两侧悬停会浮出「上一首 / 下一首」箭头；在 设置 里打开「始终显示切歌箭头」后，它们会常驻，不必每次悬停。
💡 切到歌词页按
H藏起控制条，画面只剩歌词动画，最适合沉浸地听。
把节奏握稳了，听进耳的歌总得有个去处。
把听进耳的歌留下来
收藏有两条路，都从歌曲卡片菜单进，不用绕路。
- 存成喜欢的音乐：菜单选「收藏」，成功后提示「已添加到喜欢的音乐」；
- 放进指定歌单：选「添加到歌单」，可新建歌单或选已有歌单，提示「歌单已更新」。
本地歌曲还支持在海报墙里多选后一键把选中歌曲存成歌单，省去逐首操作；本地音乐首页的「导入歌单」能读.m3u/.m3u8，打开某个本地歌单还能「导出 M3U8」，导入导出都保顺序。在线歌单的隐藏、切换、导入导出等管理入口在首页Playlists页签，完整说明见 本地音乐库管理文档。
收藏存好了，但在线歌曲为什么只能听半段？问题出在还没登录。
三步登录网易云，解锁完整在线播放
未登录时，部分在线歌曲只给 30 秒试听，也进不了在线歌单和收藏专辑。解锁步骤很短：
- 点右下角悬浮按钮，展开平台入口（比如网易云图标）；
- 扫码或账号密码登录该平台；
- 登录成功即可完整播放，并能管理在线歌单与收藏专辑。
登录成功后，你的歌单、电台和收藏专辑会铺满首页这面墙。
QQ 音乐的部署与登录方式略有差异（如 Vercel/Cloudflare 上需额外配置 API），点到为止即可，详见 QQ 音乐部署指南。
把日常闭环跑顺，Folia 已经从「能用」走向「好玩」了。
进阶玩法：全屏歌词动画、智能匹配与 AI 主题
三个招牌能力，各花两分钟就值回票价。
- 全屏歌词动画：切到歌词页按
H隐藏控制条，浮名、流光、群唱等多款动画像文字 PV 一样铺满整屏，主题预览见 README 展示区。 - 智能歌词匹配：本地歌曲导入后，按 网易云 → QQ → 酷狗 的顺序自动补全歌词与封面；匹配不准时可在匹配窗口手动选候选、恢复首次导入的本地信息。
- AI 主题生成：根据歌曲情绪与歌词内容自动生成沉浸式背景与配色，接口与 worker 端实现分别在 主题生成接口 与 worker 端实现。
整条日常闭环其实就是一句话：顶部选来源 → 右上搜索（或按S用命令面板）→Space播放 →Ctrl + →切歌 → 菜单里收藏；想再深一点，就登录平台解锁完整在线播放，再按H藏起控制条，让全屏歌词动画和 AI 主题把听歌这件事变得更好看。部署、Navidrome 配置与 Stage API 的细节，直接查 技术说明。
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
