Folia 全屏歌词播放器 10 分钟安装跑通：Windows / macOS / Linux 全路线

发布时间：2026/11/2 23:26:12

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

你在国内网络下从 Releases 直接下载常常慢得没法看，网盘链接散在角落，文档又看不太懂。本文按系统拆成 3 条路径：Windows / macOS 走网盘安装包，Arch 系走 AUR，其他 Linux 走便携版，全程 10 到 15 分钟，把全屏歌词动画跑起来。

💡 Windows / macOS 用户直接去「按系统走」对应小节；Arch / Manjaro 用户去「Linux」小节的「AUR 系」；其他发行版走「其他发行版」。网盘可能滞后于官方发布，动手前先核对 package.json 里的版本号（当前 0.7.23）。

拿：打开仓库 README.md 的「快速下载」一节，找到官方网盘链接（夸克、百度，百度提取码flia），挑 Windows 的.exe安装包。

装：

验：双击启动，主界面弹出且无黑屏。

拿：同一个「快速下载」网盘入口，挑 Apple silicon 版的.dmg；Intel 机器去仓库 Releases 页找对应安装包。

装：

验：启动后主界面弹出。

AUR 系

拿：包名folia-major-bin，需预装yay或paru等 AUR 助手。

装：

yay -S folia-major-bin

构建会自动解析alsa-lib、gtk3、nss等依赖，应用落在/opt/folia-major，并生成folia-major命令与菜单启动项。

验：终端输入folia-major回车，主界面弹出。

其他发行版（便携版）

拿：官方 Releases 页最新版folia-major-<版本>-linux-x64.tar.gz；国内慢的话先用网盘里的同版本压缩包。

装：

验：在解压目录执行./folia-major，主界面弹出。完整步骤见 packaging/linux/README-LINUX.txt。

上面三个系统小节只保证你启动成功，要确认真的跑起来，再按顺序做这三件事：

启动主界面→ 窗口弹出，无黑屏、无透明度异常切一首带歌词的歌→ 全屏歌词动画跟着歌词逐行播放在线搜索点一首→ 网易云 / QQ 音乐搜索出歌能播，歌词封面自动加载

现象	大概率原因	一条解法	备注
启动后黑屏、透明度异常或 GPU 崩溃	系统图形路径与应用不兼容	`FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major`	仍不稳定改`software`
AUR 构建卡在 tar.gz 下载或提示 404	AUR 包版本落后官方最新版	网盘拿同版本压缩包放进构建目录后`makepkg -si`	先核对版本号
其他发行版应用菜单里没有启动项	`.desktop`没装好或占位符没替换	检查文件位于`~/.local/share/applications/`且两个占位符已替换	桌面环境要求时标记为可执行
网盘里的版本比预期旧	网盘镜像滞后于官方发布	到 Releases 页比对版本号后再决定是否覆盖替换	网盘只有正式版，beta 走 Releases