Folia 安装教程：Windows / macOS / Linux 全平台下载与部署指南-港品优选

Folia 安装教程：Windows / macOS / Linux 全平台下载与部署指南

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

Folia 是一个把歌词渲染成全屏动画的桌面播放器，支持网易云、酷狗、Navidrome 与本地音乐库。这篇 Folia 下载安装教程带你走完全流程：先判断该拿哪个包，再按平台装完，最后自查与排障，顺利的话五分钟装好。

先决定拿哪个包

选错渠道会白走弯路，按「平台/芯片 → 网络环境 → 包管理习惯」三步判断：

平台/芯片：网盘镜像只有 Windows 与 Apple silicon macOS 两个包；Intel Mac 的 dmg 和全部 Linux 包都在 Releases 页面。
网络环境：国内网络且目标平台在网盘里 → 直接走网盘；其余情况 → 去 Releases 页面。
包管理习惯：Arch 系且已装 yay 或 paru → AUR 包folia-major-bin一条命令了事；其余 → 手动拿 linux-x64 便携包。

对应下来：Windows 与 Apple silicon（国内网络）走网盘，夸克或百度链接，百度提取码flia；Intel Mac 走 Releases 页面的 dmg；Arch 系走 AUR；Debian / Ubuntu / Fedora 等非 Arch 系走 linux-x64 便携包。

分平台安装

Folia Windows 安装：网盘取包，一路下一步

Windows 的安装路径最短：从网盘拿安装器，一路下一步。

打开项目README.md的「快速下载」一节，拿到夸克或百度网盘链接（百度提取码flia）。
对一眼网盘里的包版本与最新 release，明显落后就改走 Releases 页面。
下载.exe安装器，双击后按提示装完。
从开始菜单启动 Folia。

📌 注意：网盘只有 Windows 与 Apple silicon 两个包。链接失效时，以README.md「快速下载」一节的最新链接为准。

Folia Mac 下载与安装：Apple silicon 与 Intel 两条路

两条路的动作相同——挂载 dmg、把Folia.app拖进 Applications，区别只在取包位置。

Apple silicon：从网盘拿 dmg（README.md「快速下载」一节），挂载后把Folia.app拖入 Applications。

Intel：网盘没有 Intel 包，去项目 Releases 页面下载当前版本对应 Intel Mac 的 dmg，挂载后同样拖入 Applications。

⚠️ 拖完后别直接在挂载盘里运行。若 macOS 首次启动弹出「应用已损坏」或「无法验证」，是因为当前 macOS 版没有 Developer ID 签名与公证，Gatekeeper 拦截属正常现象。在终端执行：

xattr -dr com.apple.quarantine /Applications/Folia.app # 移除下载隔离属性，再从 Applications 重新打开

📌 常见坑：每次手动重装后隔离属性都会回来，需要再执行一遍上面的命令。

Folia AUR 安装：Arch 系一条命令

已装 yay 或 paru 的 Arch 用户，AUR 是自动化程度最高的一条路。

确认 AUR 助手可用：

yay --version # 确认 AUR 助手已安装（paru 用户把命令名换成 paru）

安装预编译二进制包：

yay -S folia-major-bin # 构建时从 Releases 拉 linux-x64 包，装进 /opt/folia-major

验证命令可直接执行（包会在/usr/bin建软链接）：

which folia-major # 输出 /usr/bin/folia-major 即安装成功

在应用菜单里找到 Folia，启动它。

📌 常见坑：AUR 包当前版本0.1.4，依赖alsa-lib、gtk3、libxss、nss，可在packaging/aur/folia-major-bin/PKGBUILD逐项核对；构建卡在下载步骤多为网络问题，别干等，直接转下面的便携包。

Folia Linux 部署：Debian / Ubuntu / Fedora 便携包手动装

非 Arch 系发行版，官方只给便携包这一种形态，需要自己解压到固定目录。

到 Releases 页面下载当前版本的 linux-x64 包，文件名形如folia-major-<version>-linux-x64.tar.gz。
解压到一个固定目录：

mkdir -p ~/Apps/Folia && tar -xzf folia-major-*-linux-x64.tar.gz -C ~/Apps/Folia # 整套程序放进固定目录

把便携包自带的桌面项模板复制到用户级应用目录：

cp ~/Apps/Folia/resources/linux/folia-major.desktop ~/.local/share/applications/ # 复制桌面项模板

打开复制出的.desktop文件，填对两处占位符：__APP_PATH__填folia-major可执行文件的绝对路径，__ICON_PATH__填resources/linux/icon.png的绝对路径。
桌面环境有要求时，将该.desktop标记为可信，再从应用菜单启动 Folia。

📌 常见坑：便携包一共三样东西：folia-major可执行文件、resources/linux/icon.png与桌面项模板。排查问题时先确认可执行文件与resources/位于同一便携包目录。

装完之后

装没装好不挑平台，满足下面三条就算完成：

应用菜单里出现 Folia 条目（Windows 看开始菜单、macOS 看 Applications、Linux 看应用菜单）
点开后能进入首页，看到歌单 / 文件夹标签页和搜索框
随便播放一首歌，能看到全屏歌词动画动起来

Linux 黑屏解决：切换渲染模式

Linux 启动后若黑屏、透明度 / 模糊异常或 GPU 崩溃，先别怀疑装坏了，通常是图形路径问题，用环境变量切换渲染模式即可。

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major # 以 swiftshader 软件渲染方式启动

swiftshader 下仍不稳定的话，把变量值改成software，即最保守的软件渲染档位：

FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major # 最保守的软件渲染档位

出了问题

按「现象 → 处理」列出最常遇到的几类情况：

网盘里找不到自己平台的包（Intel Mac、各类 Linux）→ 网盘只有 Windows 与 Apple silicon 两个包，去 Releases 页面取对应平台的包。
网盘版本落后于最新 release，或链接失效→ 以README.md「快速下载」一节的最新镜像链接为准，仍不行就改走 Releases。
AUR 构建卡在下载步骤→ 放弃 AUR，转 linux-x64 便携包手动部署。
macOS 提示「应用已损坏」或「无法验证」→ 终端执行xattr -dr com.apple.quarantine /Applications/Folia.app移除隔离属性，再从 Applications 重新打开。
Linux 启动黑屏、透明度异常或 GPU 崩溃→ 用FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major启动；仍不稳定再把值改成software。
桌面快捷方式不显示→ 检查.desktop文件的Exec/Icon是否填了绝对路径，并把该文件标记为可信。

企业官网建设流程全解析