Folia 全屏歌词播放器 5 分钟装好：从取包到首次启动一步到位指南

2026/11/3 1:48:57

【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major

Folia 是把歌词渲染成全屏动画的桌面音乐播放器。支持 Windows、macOS、Linux 三端，兼容网易云、酷狗、QQ 音乐等在线音源、Navidrome 与本地音乐库。本文带你完成 Folia 的安装到首次启动，顺利的话 5 分钟左右走完。

系统是什么？Windows 10/11 → 取 exe 安装包；macOS → 取 dmg，看芯片架构选包；Linux → 接着答第 2 题。
Linux 是哪个发行版？Ubuntu/Debian/Mint 系 → 取.deb；Arch/Manjaro → 走 AUR；其他发行版 → 用便携 tar.gz 手动部署。
Arch 系装过 yay 或 paru 吗？装过 → AUR 路线最省事；没装 → 直接走便携包。
只想要浏览器版？跳过桌面端，按 deploy/docker/README.md 用 Docker Compose 部署。本地音乐库接入需要可信 HTTPS 环境。

到仓库 Releases 页面下载Folia-Setup-0.7.22.exe。拿不到 Releases 时，可走网盘镜像（夸克/百度，提取码flia），但版本可能落后。验证点：文件大小为 0 就是没下完整，删掉重下。
双击安装包运行。验证点：出现带进度的安装窗口，目录保持默认即可。
按提示完成安装。验证点：开始菜单出现 Folia 条目。
从开始菜单启动。验证点：首页加载出来，搜索框可以输入文字。
登录一个在线音源，或导入本地文件夹，搜索一首歌。验证点：搜索出结果并能播放。

macOS（dmg 路线）

按芯片取包：Apple silicon 用Folia-0.7.22-arm64.dmg，Intel 用Folia-0.7.22-x64.dmg。打开后把 Folia 拖进 Applications 文件夹。验证点：应用列表出现 Folia。
首次启动被拦、提示"无法打开"时，到系统设置 → 隐私与安全性允许，或右键图标选"打开"。验证点：再次启动不再弹拦截提示。

Linux（三条路线任选其一）

Ubuntu/Debian/Mint：Releases 取.deb，执行sudo dpkg -i安装。验证点：应用菜单出现 Folia 条目。
Arch/Manjaro（yay 或 paru）：yay -S folia-major-bin。构建卡在下载步骤就是在取 Releases 的包，别干等，切便携包路线。
其他发行版：把便携包解压到固定目录，tar -xzf folia-major-0.7.22-linux-x64.tar.gz -C ~/Apps/Folia。验证点：目录里folia-major可执行文件与resources/目录同级。
再建桌面项：把resources/linux/folia-major.desktop复制到~/.local/share/applications/，打开复制后的文件，__APP_PATH__改成folia-major的绝对路径，__ICON_PATH__改成resources/linux/icon.png的绝对路径。验证点：应用菜单出现 Folia 条目；部分桌面还要把它标记为可信。

现象	处理
Linux 黑屏、透明度或模糊异常	用`FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major`重启，画面恢复即显卡驱动不兼容
swiftshader 下仍不稳定	日常启动改用`FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major`，最保守
AUR 构建卡在下载步骤	它同样从 Releases 取包，别干等，回便携 tar.gz 路线
桌面快捷方式不显示	核对`Exec`与`Icon`是绝对路径、无`__APP_PATH__`残留，并按桌面要求标记可信
网盘里找不到对应平台的包	网盘只有 Windows 与 Apple silicon，其余平台以 Releases 页面为准
macOS 提示"无法打开"	系统设置 → 隐私与安全性中允许，或右键应用图标选"打开"