Folia 歌词动画播放器安装指南：从下载到启动的分系统避坑讲解
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
在国内下载 Folia，官方源容易慢、容易中断。本文按系统拆好步骤，带你把歌词动画播放器装到位，按系统取最快的下载源，装完就能播放。
按系统选定安装路线
- Windows→ 看「Windows / macOS：网盘镜像安装步骤」，取
.exe。 - macOS（Apple 芯片）→ 同上一节，取
.dmg。 - Arch Linux→ 看「Arch：AUR 包管理器安装」，一条 AUR 命令搞定。
- 其他 Linux 发行版→ 用 Linux 便携版压缩包解压即用，说明跟在 Arch 一节后面。
Windows / macOS：网盘镜像安装步骤
- 打开仓库 README.md「快速下载」一节，记下夸克、百度两个网盘入口。预期：页面上出现两条网盘链接，百度附提取码
flia。 - 把链接转存到自己账号，再下载与系统匹配的包：Windows 选
.exe，macOS 选 Apple silicon 的.dmg。预期：文件体积与官方标注一致。 - 运行安装包，按默认选项走完全程。预期：开始菜单或 Applications 里出现 Folia 启动项。
- 启动应用，连接网易云或本地音乐库任一，播放一首歌。预期：全屏歌词动画正常渲染。
⚠️ 网盘镜像只有 Windows 与 Apple silicon 正式版，版本号可能落后。拿包前先对照官方发布页的最新编号，不一致就直接去发布源取。
Arch：AUR 包管理器安装
前置检查。确认 AUR 助手就位：
yay --version输出里能看到版本号即可继续；没有的话，先按 Arch 官方 wiki 装好 yay。
安装命令：
yay -S folia-major-bin完成判定。构建结束后，程序落到/opt/folia-major，生成folia-major命令，系统菜单多出一个启动项。运行依赖为alsa-lib、gtk3、libxss、nss，见仓库packaging/aur/folia-major-bin/PKGBUILD。
⚡ 卡在拉取
folia-major-<版本>-linux-x64.tar.gz这一步时：把手动下好的同版本压缩包放进 AUR 构建源码目录，再用makepkg -si完成构建。
其他发行版：从发布源取 Linux 便携版压缩包，解压后直接运行其中的folia-major可执行文件；创建桌面启动项参照 packaging/linux/README-LINUX.txt。
Folia 安装自检清单
- 主窗口正常启动。通过标准：界面正常呈现，无黑屏白屏。
- 至少一个音乐源连通。通过标准：网易云或本地库任选其一，能加载出歌曲列表。
- 播放后出全屏歌词动画。通过标准：当前歌词行与音频同步，不漂移。
Arch 安装另外确认命令路径可用，期望输出：
which folia-major/usr/bin/folia-major常见问题速修
症状：Linux 启动后界面黑屏、透明度或模糊异常、进程崩溃。修法：附加图形环境变量重启；仍不稳定就改用software值：
FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major该变量只作用于 Electron Linux 启动参数，细节见 packaging/linux/README-LINUX.txt。
症状：AUR 构建进度停在压缩包下载环节。修法：把手动下载的同版本folia-major-<版本>-linux-x64.tar.gz放进 AUR 构建源码目录，再执行makepkg -si。
症状：网盘里的包对不上最新版。修法：镜像只有 Windows 与 Apple silicon 版本且可能滞后，以官方发布页最新版本号为准；Wayland、遥控窗等桌面细节查 docs/technical.md。
下载与启动两头都不绕路，Folia 即装即用 🎵
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
