Folia 全屏歌词播放器完整安装指南：三条路线任选，最快 5 分钟上手
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia（仓库 folia-major）是一个以全屏歌词动画为核心的桌面音乐播放器，能接网易云、QQ 音乐、酷狗、Navidrome，也能播放本地音乐库。国内装它最大的坎往往只有一个：GitHub Releases 下载太慢，环境却不用折腾。好消息是有三条路可选——Windows/macOS 走官方网盘、Arch 走 AUR 一条命令、其他 Linux 解压即用，最快 5 分钟装完。
按系统对号入座，选一条安装路线
| 你的系统 | 推荐路线 | 拿到的东西 | 预计耗时 |
|---|---|---|---|
| Windows 10 / 11 | 官方网盘下载.exe | Windows 安装包 | 约 5 分钟 |
| macOS（Apple silicon） | 官方网盘下载.dmg | macOS 安装包 | 约 5 分钟 |
| Arch Linux 及衍生版 | AUR 构建folia-major-bin | pacman 自动装依赖 | 约 5 分钟 |
| Debian / Ubuntu / Fedora 等 | Releases 便携压缩包 | 解压即用，无需 root | 约 10 分钟 |
拿不准就按"最常见 → 最特殊"往下读，第一条覆盖大部分用户。
路线一：Windows/macOS 官方网盘一键装好（约 5 分钟）
谁该走这条：Windows 10/11 和 Apple silicon 的 macOS 用户。官方网盘在国内速度最快，而网盘恰好只镜像这两个平台的正式版安装包，正好对得上。
- 打开 README.md 的「快速下载 / 直接下载」小节，复制官方夸克网盘或百度网盘入口。
- 用网盘客户端登录，先把文件转存到自己网盘，再开始下载。
- Windows 拿
.exe安装包，Apple silicon 的 macOS 拿.dmg；百度网盘的提取码是flia。 - 双击安装包，一路默认选项装完。
⚠️ 只走 README 里的官方网盘入口，来路不明的第三方转发包一律别碰。
完成信号：启动应用后直接看到全屏歌词播放界面——桌面版内置前后端环境，不需要再装任何运行库。
路线二：Arch 一条命令装好 folia-major-bin（约 5 分钟）
谁该走这条：Arch Linux 及 Manjaro、Endeavouros 等 Arch 系用户。让 pacman 把依赖一次处理干净，系统状态最清爽。
- 先确认手头有 AUR helper（
yay或paru均可），没有就先从 AUR 构建一个（helper 本身就是个 AUR 包）。 - 执行安装命令：
yay -S folia-major-bin用 paru 的话把yay换成paru。alsa-lib、gtk3、libxss、nss四个依赖会自动装好。
- 构建会从 Releases 拉同版本 tar.gz，装完后程序位于
/opt/folia-major，/usr/bin/folia-major链接与应用菜单启动项自动生成。 - 核对版本：
pacman -Qs folia-major-bin完成信号：输出里能看到包条目，且版本号与 Releases 当前版一致（0.7.23）。
⚡ 构建卡在拉压缩包时，手动把同版本folia-major-0.7.23-linux-x64.tar.gz放进构建源码目录，再跑makepkg -si即可跳过慢速下载。构建逻辑与版本同步方式见 PKGBUILD 与 update.sh。
路线三：其他发行版解压即用 Linux 便携版（约 10 分钟）
谁该走这条：Debian、Ubuntu、Fedora 等普通 Linux。网盘里没有 Linux 包，但 Releases 的便携压缩包解压就能跑，不需要 root，也不怕版本源打架。
- 到 Releases 页面下载
folia-major-0.7.23-linux-x64.tar.gz，网速慢就挂着后台下。 - 解压到一个你记得住的固定位置，例如
~/Apps/Folia，别把文件散开：
mkdir -p ~/Apps/Folia && tar -xzf folia-major-0.7.23-linux-x64.tar.gz -C ~/Apps/Folia- 进入该目录执行
./folia-major，窗口弹出即成功。 - 想在应用菜单注册启动项：把包内
resources/linux/folia-major.desktop复制到~/.local/share/applications/，再把其中__APP_PATH__、__ICON_PATH__两个占位符替换为可执行文件和resources/linux/icon.png的绝对路径，完整示例见 README-LINUX.txt。
⚠️ 可执行文件和resources/目录必须留在同一便携包目录内，排查问题前先确认这一点。
完成信号：应用菜单里出现 Folia 图标，或./folia-major能弹出窗口，两者有一即算装好。Linux 图形兼容与壁纸模式细节另见 README-LINUX.txt 和 docs/technical.md。
常见症状速查：症状 → 原因 → 解法
| 症状 | 原因 | 解法 |
|---|---|---|
| Linux 启动后黑屏、透明度/模糊异常或 GPU 崩溃 | 显卡渲染兼容问题 | 用FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major启动；仍不稳定再退回FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major |
| 网盘里的包比最新版旧 | 网盘镜像同步有延迟 | 到 Releases 页面核对版本号，以 README「直接下载」入口为准 |
| AUR 构建卡在下载压缩包 | Releases 拉包速度慢 | 把同版本 tar.gz 提前放进构建源码目录，再执行makepkg -si |
| 装了便携版却不见应用菜单启动项 | .desktop占位符没替换 | 确认__APP_PATH__、__ICON_PATH__已换成实际绝对路径，且文件位于~/.local/share/applications/ |
按系统挑一条：Windows/macOS 走网盘，Arch 敲一条命令，其他 Linux 解压即跑，5 分钟左右就能让 Folia 的全屏歌词亮起来。🎵
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考