Folia 全屏歌词播放器安装教程：Windows、macOS、Linux 三步上手
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是一个全屏歌词播放器，能把歌曲歌词变成铺满整块屏幕的动画。这篇安装指南覆盖 Windows、macOS 和 Linux 三个平台，带你把包下对、装好、启动验证一次走完。
它到底是个什么东西
桌面版把前端和后端运行环境全部打包进了安装程序，装完直接打开就能用，不需要你本机装 Node.js 或任何开发工具。音源方面，它支持网易云音乐、QQ 音乐、酷狗在线登录，也可以接入 Navidrome 和自己的本地音乐库——在线、自建、本地三种来源任选其一，都能驱动后面的全屏歌词动画。
下载前先对号入座
先按你的系统和芯片在表里找到对应的包，别凭感觉选：
| 系统 | 目标芯片 | 文件格式 | 下载渠道 |
|---|---|---|---|
| Windows | 64 位 | .exe | Releases 页或官方网盘镜像（夸克、百度） |
| macOS | Apple silicon | .dmg | Releases 页或网盘镜像 |
| macOS | Intel | .dmg | 仅 Releases 页 |
| Linux | x86_64 / ARM（互不通用） | .tar.gz | 仅 Releases 页 |
网盘镜像只覆盖 Windows 和 Apple silicon 的正式版，Intel Mac 和 Linux 的包只能去 Releases 页取。
三个系统，三种装法
不管哪个系统，下载完成后先做同一件事：核对版本号。文件名里标的版本要和 Releases 页最新标注一致，对不上就先等镜像同步，或者直接回 Releases 重新下。
Windows：双击 .exe 走完向导
按上表取 64 位 .exe，双击后跟着安装向导一路点完即可。开始菜单里能看到 Folia 图标，说明装到了位。接着启动一次，登录一个在线音源，随便放一首带歌词的歌——屏幕被歌词动画铺满，这步就算稳了。
macOS：拖进 Applications 就行
打开 .dmg，把 Folia 拖进 Applications 文件夹。之后在启动台里能看到 Folia 图标，就说明安装完成。首次启动时登录音源或导入本地文件夹，放一首有歌词的歌确认动画正常亮起，就可以收工了。
Linux：解压即跑
把 .tar.gz 解压到任意目录，直接运行里面的可执行文件。如果你想在应用菜单里常驻入口，README-LINUX.txt 里写了做法：把模板复制到~/.local/share/applications/，再把__APP_PATH__、__ICON_PATH__两个占位符换成实际绝对路径，按桌面环境要求标记为可信。
桌面端之外的选择
- AUR 安装（Arch 发行版）：不用手动下包，一条
yay -S folia-major-bin就装完，paru 用户把yay换成paru即可。依赖自动解决，程序装到/opt/folia-major，应用菜单出现 Folia 且能点开就成功；想核对依赖和安装位置，看 PKGBUILD。 - 本地构建提速：构建阶段拉压缩包太慢的话，可以先用网盘下好同版本的 Linux 压缩包，放进 AUR 源码目录，再执行
makepkg -si。 - Web / PWA 部署：不想装桌面端，可以把项目部署到 Vercel、Cloudflare 或 Docker，浏览器里直接听；页面添加为 PWA 之后手机也能当 App 用，适合 NAS 和移动场景。完整步骤在 deploy/docker/。
装完，用这几项确认
- 🏷️ 版本：「关于」页显示的版本号和安装包名里的版本一致
- 🔑 音源：成功登录一个在线音源，或导入本地文件夹、接入 Navidrome
- 🎤 歌词：播放一首带歌词的歌，全屏动画正常亮起
- 🎨 主题：切换两三个主题，感受不同排版氛围
这几项都过一遍，安装就算扎实了，接下来怎么播随你。
翻车了先查这里
下载总是断
- 现象：从 GitHub Releases 直连下载慢或反复断流
- 先怀疑什么：网络直连问题，不是包本身有问题
- 怎么处理：换官方网盘镜像（夸克、百度）取回，再核对一遍版本。注意 Linux 的 .tar.gz 没有镜像，只能走 Releases 页
Linux 启动黑屏或闪退
- 现象：程序能起但画面黑屏，或直接退出
- 先怀疑什么：GPU 兼容问题，而不是安装失败
- 怎么处理：先用
FOLIA_LINUX_GRAPHICS_MODE=swiftshader以软件渲染启动验证；仍不稳定就切到更保守的software模式；确认是显卡问题后，再用system值恢复系统图形路径
拿错包了
- 现象：装上打不开、装不上，或平台明显不对
- 先怀疑什么：平台选错——Intel Mac 装了 Apple silicon 版，或 Linux 选错了 CPU 架构
- 怎么处理：文件名都带平台标识，回 Releases 页面逐字比对一次，重新下载正确的那个
最后一件事其实很简单：挑一首有歌词的歌按播放，看整块屏幕自己亮起来。
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
