Folia 全屏歌词播放器安装指南：从下载到点亮第一句歌词
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是一个把歌词做成全屏动画的 Electron 桌面播放器，支持网易云音乐、QQ 音乐、酷狗、Navidrome 在线音源，也支持本地音乐库。这篇 Folia 全屏歌词播放器安装教程只带你走一条路：拿到 Windows 桌面安装包，把第一首歌的歌词亮满整块屏幕。顺利的话十分钟跑通，不用预装 Node.js 或任何开发工具，全程不用看一行代码。
🎨 先预览 Folia 的全屏歌词效果
装之前先说清你能得到什么：
- 全屏歌词动画：浮名、流光等多套歌词动画，各自不同的排版氛围，自动适配窗口尺寸。
- 多源播放：在线音源搜索即播，也能导入本地文件夹建曲库。
- AI 主题生成：基于歌曲情绪与歌词内容，生成沉浸式背景和配色。
✅ 下载前核对系统、芯片与网络
- 看系统：Windows、macOS、Linux 都有官方桌面版安装包，选自己那份。
- 看芯片：Intel Mac 与 Apple silicon 是两套不同的包；Linux 分 x64 与 ARM，按架构选。
- 看网络：GitHub Releases 页访问慢就走官方网盘镜像（夸克 / 百度），但镜像只收录 Windows 与 Apple silicon 包。
🪟 四步装完 Windows 版 Folia
- 下载：进 Releases 页拿最新 Windows
.exe；国内网络也可以看 README.md 「快速下载」一节的网盘镜像链接。⚠️ 网盘镜像偶尔比 Releases 页晚一个版本，文件名里的版本号与 Releases 页最新值对不上时，先等等再下。
- 双击：打开
.exe，按向导一路下一步装完；桌面版已内置运行环境，不用装任何依赖库。 - 启动：开始菜单里找到 Folia，点进主界面。
- 放歌：登录一个音源（网易云、QQ 音乐或酷狗），或导入本地文件夹建曲库，随便放一首带歌词的歌——全屏歌词动画会自动亮起来。
🗺 速览 macOS、Linux 与 Web 的 Folia 安装
macOS：左上角苹果菜单 →「关于本机」先认芯片，Apple M 系列取 Apple silicon 版.dmg，Intel 版只能去 Releases 页。双击.dmg把应用图标拖进 Applications，拖完即装好。
Linux：Arch / Manjaro 装了 AUR Helper（yay 或 paru），一条命令解决：
yay -S folia-major-bin这条命令从 AUR 拉取预构建包安装，alsa-lib、gtk3等依赖自动解决。其他发行版从 Releases 页下对应架构的.tar.gz，解压后folia-major可执行文件直接能跑，完整流程见 packaging/linux/README-LINUX.txt。
Web：目标是 NAS 或手机的话，把仓库部署到 Vercel 或 Cloudflare，或照 deploy/docker/README.md 做全栈部署；部署完在浏览器里把网页加到主屏幕，当 PWA 用。
✔️ 两条判断式核对 Folia 跑通标准
- 版本对得上：进「关于」页看版本号，和你刚下的包一致——装对了。
- 歌词亮起来：放一首带歌词的歌，全屏歌词动画自动点亮，这就是你的第一次成功画面：
🩺 Folia 常见问题速查
| 现象 | 原因 | 处理 |
|---|---|---|
| Linux 启动黑屏、透明度异常或闪退 | 通常是 GPU 兼容问题，不是装坏了 | 用FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major强制软件渲染启动，能开就是显卡问题，排除后设system恢复 |
| macOS 首次启动提示「无法打开」 | Gatekeeper 来源校验拦了未识别应用 | 右键应用图标选「打开」，弹窗里再确认一次即可放行 |
| Windows 下载缓慢、连接中断 | 国内网络到 Releases 页链路差 | 改走官方网盘镜像（夸克 / 百度）下载，镜像只有 Windows 与 Apple silicon 包 |
🚀 跑通后开始定制歌词主题
跑通即快速上手结束。下一个动作：去设置里把歌词动画主题逐个切一遍，挑一个最合眼缘的。本地曲库的导入、匹配与缓存细节，看 docs/local-library-management.md。
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
