Folia 下载安装指南：Windows、macOS、Linux 三平台从取包到启动
【免费下载链接】folia-major 专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 
项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
歌词动画播放器 Folia 的下载安装，常见卡住的地方只有三个：包从哪取、安装动作怎么走、装完起不来怎么修。这篇指南覆盖 Windows、macOS 与全部 Linux 发行版，所有命令、路径与版本号均可直接照抄，装完的目标是：桌面或应用菜单出现一个可点击的入口，点开就能看到在线音源或本地音乐库的首页。🎵
装完长什么样：先确认验收标准
Folia 把歌词渲染成全屏动画，桌面端支持网易云音乐、酷狗、Navidrome 以及本地音乐库。判断安装是否成功，只看两点：
Windows 快速安装步骤
取包只有一条正路：打开仓库 README.md 的「快速下载」一节，那里挂着夸克网盘、百度网盘两个国内镜像（网盘里百度盘的提取码是 flia）。下载对应平台的 .exe 安装包，运行后按向导点完即可。
启动菜单里出现 Folia、点开是首页，说明这步已经成功。
有个前提先说明白：网盘镜像只放了 Windows 与 Apple silicon 两种安装包，Intel Mac 和 Linux 都不在其中；镜像的版本也可能比最新 release 落后，取包前对一下版本号。若发现链接失效或版本过旧，一律以 README「快速下载」一节的最新链接为准。
macOS 安装步骤
- Apple silicon（M 系列芯片）：走上面 Windows 同一节的网盘镜像，下载 .dmg 镜像文件，挂载后按提示完成安装，Applications 里应出现 Folia。
- Intel Mac：网盘没有对应包，别在这上面耗时间，直接去 Releases 页面取 Intel 版的 dmg 即可。
Linux 安装方式
Arch Linux：一条 AUR 命令
如果你手上是 Arch 或 Arch 系发行版，事情会简单很多。先确认 AUR 助手可用（终端执行 yay –version 看一眼），然后执行：
yay -S folia-major-bin # 用 paru 的用户改成 paru -S folia-major-bin
验证方式：终端能直接执行 folia-major 命令，应用菜单里出现 Folia 条目，从菜单启动能看到首页即成功。
两个背景信息值得知道：AUR 包本质上仍是去 Releases 页面拉取 linux-x64 的 tar.gz，再装到 /opt/folia-major；运行时依赖 alsa-lib、gtk3、libxss、nss 四项，当前包版本 0.1.4，都可以到 packaging/aur/folia-major-bin/PKGBUILD 里核对。如果构建卡在下载环节，别干等，直接改用下面这节的便携部署。
Debian / Ubuntu / Fedora：便携版手动部署
tar -xzf folia-major-0.1.4-linux-x64.tar.gz -C ~/Apps/Folia
桌面快捷方式不显示时，回到第 4 步检查 .desktop 里的 Exec / Icon 是否都是绝对路径、文件是否已标记可信。
Linux 启动黑屏、显示异常怎么办
先排一个高频坑：启动后黑屏、透明度或模糊表现异常、甚至直接 GPU 崩溃，多半不是装坏了，而是渲染栈的问题，先切软件渲染再下结论：
FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major
swiftshader 下仍不稳定的机器，可以再退一档，改用更保守的 FOLIA_LINUX_GRAPHICS_MODE=software。
延伸阅读
- docs/technical.md：Linux 图形模式、Wayland / Hyprland 遥控窗等桌面端细节，部署后遇到显示层问题先翻这里。
- deploy/docker/README.md：Docker Compose 全栈部署 Web 版本，不想装桌面端时的另一条路。🎵
【免费下载链接】folia-major 专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
