Folia 歌词动画播放器安装教程：Windows、macOS、Linux 全覆盖，3 分钟一次跑通
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 A multi-platform music player for local files, Navidrome, and online streaming services, featuring stunning animated lyrics.项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是一款把歌词铺满全屏、随节奏逐字渲染的歌词动画播放器，支持网易云、QQ 音乐、酷狗、Navidrome 在线源与本地音乐库。这篇 Folia 安装指南覆盖 Windows、macOS、Linux 三条路线，读完即可完成 Folia 安装并放出第一首带全屏歌词动画的歌。
先看效果：Folia 歌词动画长什么样
装好后点开任意一首歌，歌词会占据整块屏幕，随节拍一行行点亮，背景配色与动效参数由歌曲情绪自动生成：
安装选路：你的系统走哪条路线
两条通用前提：网络能访问 GitHub Releases（访问不了就用官方网盘镜像，README「快速下载」一节给出了夸克与百度网盘入口，提取码flia）；Linux 上除便携版外的路线需要sudo权限。对号入座：
| 你的系统 | 推荐路线 | 预计耗时 | 是否需要管理员权限 |
|---|---|---|---|
| Windows | 官方 .exe 安装 | 2 分钟内 | 安装器中途会请求提权 |
| macOS（Apple silicon） | 官方 .dmg 拖拽安装 | 2 分钟内 | 否 |
| Arch / Manjaro | AUR 一条命令 | 1 分钟内 | 否 |
| Debian / Ubuntu / Linux Mint | 官方 .deb 包 | 3 分钟内 | 是（sudo） |
| Fedora / RHEL / openSUSE | 官方 .rpm 包 | 3 分钟内 | 是（sudo） |
| 其他 Linux 发行版 | tar.gz 便携版 | 3 分钟内 | 否 |
下文文件名中的<version>一律以官方 Releases 页面实际版本号为准确定选哪个包。
安装实操：四个平台各走一步
Folia Windows 安装：双击官方安装包
下载什么：Folia-Setup-<version>.exe官方安装包（Releases 下载慢时可用网盘镜像替代）。
怎么装：
- 从 Releases 页面（或网盘镜像）下载 exe 安装包。
- 双击运行，按向导一路装完，中途可以修改安装位置。
怎么算装好：开始菜单和桌面出现 Folia 快捷方式，双击打开不报错。
Folia macOS 安装：.dmg 拖进 Applications
下载什么：Folia-<version>-arm64.dmg（dmg 是 macOS 的安装磁盘镜像；Apple silicon 选 arm64 后缀，Intel Mac 选 x64 后缀）。
怎么装：
- 下载 dmg，打开后把
Folia.app拖进Applications文件夹，不要直接在挂载盘里运行。 - 当前版本没有 Apple 开发者签名，首次打开前在终端移除下载隔离属性（浏览器下载会附带
com.apple.quarantine标记，Gatekeeper 因此拦截未签名应用）：
xattr -dr com.apple.quarantine /Applications/Folia.app怎么算装好：从「应用程序」打开不报错，也不弹「已损坏 / 无法验证」提示。详细说明见 macOS 损坏提示说明。
Folia Linux 安装：按发行版选 AUR、.deb 或 .rpm
Arch / Manjaro：AUR 一条命令
AUR 是 Arch 的社区软件仓库，yay 是从 AUR 装包的命令行工具（paru 亦可）。先确认工具可用：
yay --version能打印版本号。- 执行安装，构建会自动从 Releases 拉取
folia-major-<version>-linux-x64.tar.gz，解包进/opt/folia-major，并生成命令与桌面菜单项：
yay -S folia-major-bin怎么算装好：
which folia-major输出/usr/bin/folia-major即成功。
Debian 系：装官方 .deb 包
- 下载
folia-major-<version>-linux-x64.deb。 - 用系统自带的包管理器 dpkg 安装：
sudo dpkg -i folia-major-*.deb- 若提示缺依赖，执行
sudo apt -f install补齐。
怎么算装好：dpkg -s folia-major显示状态install ok installed。
Fedora / RHEL / openSUSE：装官方 .rpm 包
- 下载
folia-major-<version>-linux-x64.rpm。 - 安装：
sudo dnf install ./folia-major-*.rpm怎么算装好：rpm -q folia-major能打印出版本号。
Folia 便携版：任意 Linux 解压即用
下载什么：folia-major-<version>-linux-x64.tar.gz，不需要 root，适合其余发行版。
怎么装：
- 解压到任意目录，例如
~/Apps/Folia/，包内含可执行文件folia-major、图标与桌面启动项模板resources/linux/folia-major.desktop。 - 进入该目录直接运行：
./folia-major- 想加桌面启动项：把
.desktop模板复制到~/.local/share/applications/，再把文件里的__APP_PATH__、__ICON_PATH__两个占位符替换为可执行文件与图标的实际绝对路径，模板用法见 Linux 便携版说明。
怎么算装好：终端不报错、弹出主窗口，便携包即可长期使用。
首次启动三步验收
装完别急着关掉终端，按顺序过三步，每步一句话：
- 窗口正常打开：主窗口出现且不是黑屏。
- 接上数据源：导入一个本地音乐文件夹，或登录任一在线源，点开任意一首歌。
- 播放验收：点播放，全屏歌词动画随节奏渲染出来——走到这一步，安装才算真正完成。
故障排查：按症状对解法
| 症状 | 处理办法 |
|---|---|
| Linux 启动黑屏、透明度异常或 GPU 崩溃 | 改用软件渲染FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major；仍不稳定则用最保守的FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major，详见 Linux 便携版说明 |
| macOS 提示「Folia.app 已损坏 / 无法验证」 | 包没坏，是当前版本未做 Apple 签名；终端执行xattr -dr com.apple.quarantine /Applications/Folia.app后重新打开 |
| macOS 重装覆盖后同样的提示再次出现 | 每次覆盖安装都会重新带上隔离属性，把上面的 xattr 命令再执行一遍即可 |
| X11 下提示没有可用的 WebGPU | 手动开启 Vulkan：FOLIA_LINUX_VULKAN=1 ./folia-major --ozone-platform=x11（仅 X11 环境有效，原生 Wayland 下该变量会被忽略） |
| AUR 条目版本号落后于 Releases 最新版 | 别等条目更新，直接改走便携版路线 |
| 网盘里的包和最新版对不上 | 网盘镜像只提供 Windows 与 Apple silicon 的正式版且可能滞后一个版本，以 Releases 页面版本号为准，通道规则见 技术与开发说明 |
路线选对，3 分钟后全屏歌词动画就在你屏幕上跑起来了。下一步：进入「设置 → 模组」打开模组系统，从模组市场装一个新歌词动画，换一套完全不同的渲染风格 🎵
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 A multi-platform music player for local files, Navidrome, and online streaming services, featuring stunning animated lyrics.项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
