三步装好 Folia：第一次打开就铺满全屏歌词
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是一款以全屏歌词动画为招牌的播放器，支持本地音乐库、Navidrome、网易云、QQ 音乐等在线音源。这篇 Folia 安装指南只解决一件事：从零走到成功启动。全程约十分钟，你只需挑中下面某个小节照着做。读完按完最后一个回车，装好的 Folia 里正播着一首歌，歌词随节奏铺满整块屏幕。
30 秒自检
先花 30 秒给自己定位。系统是什么？决定你走哪个小节。是 Apple 芯片还是 Intel？打开「关于本机」就能确认，macOS 两种芯片的包不一样。Linux 属于哪个家族？Arch 系走 AUR 社区包，Debian 系装.deb，Fedora / openSUSE 装.rpm，其余用便携版兜底。官方 Releases 页面能否直连？打开看 3 秒，能下就下；不稳定就按各小节里的替代渠道拿包。
方案一：AUR 渠道，一条命令装完
适合 Arch 与 Manjaro，是全文最短的一条路。
准备：先确认 AUR 助手可用，yay --version能打印版本号即可；paru同理。没有就按 Arch 官方 wiki 先装一个。
操作：
执行下面这条命令，助手会自动从 Releases 拉取同版本
tar.gz并完成构建安装：yay -S folia-major-bin依赖的
alsa-lib、gtk3、libxss、nss四个包由助手自动处理，无需手动安装；拉包与构建规则见 packaging/aur/folia-major-bin/PKGBUILD。
装完看到什么：终端里输入folia-major能直接拉起主窗口，桌面应用菜单里出现 Folia 入口，程序本体落在/opt/folia-major。
方案二：下载官方安装包
四种形态对应同一个应用，按发行版和芯片取文件即可。装完别急着关终端，先按各小节末尾的信号核对一遍。
Windows：exe 安装向导
准备：到 README.md「快速下载」一节取网盘分享（提取码flia），在里面找Folia-Setup-<版本>.exe。先转存到自己的网盘再下载，分享直链容易限速。
操作：
- 双击
exe，安装向导支持中文，一路下一步。 - 装到默认位置或自选目录都可以。
装完看到什么：开始菜单与桌面各出现一个 Folia 快捷方式，双击能启动。若网盘里的版本落后一档，直接从官方 Releases 页面下新版exe覆盖安装即可，不用卸载。
macOS：dmg 拖进应用程序
准备：打开「关于本机」确认芯片——Apple M 芯片下载Folia-<版本>-arm64.dmg，Intel 芯片下载带x64后缀的包。
操作：
- 从官方 Releases 页面（网络不畅走网盘分享）下载
dmg，双击挂载出安装窗口。 - 把窗口里的
Folia.app拖进「应用程序」文件夹。
装完看到什么：「应用程序」里出现Folia，启动台里也能找到。不要从挂载盘直接运行，弹出镜像后正在运行的应用会立刻崩溃。
Debian / Ubuntu / Mint：dpkg 装完再补依赖
准备：下载folia-major-<版本>-linux-x64.deb。
操作：dpkg只负责解包注册，不处理依赖，所以分两步走：
执行解包安装：
sudo dpkg -i ~/Downloads/folia-major-<版本>-linux-x64.deb若提示缺少依赖，让
apt自动补齐：sudo apt -f install
装完看到什么：应用菜单出现 Folia 入口，dpkg -s folia-major显示install ok installed。
Fedora / RHEL / openSUSE：rpm 本地包
准备：下载folia-major-<版本>-linux-x64.rpm。
操作：
sudo rpm -i ~/Downloads/folia-major-<版本>-linux-x64.rpm依赖由rpm解析时顺带处理；如果你的发行版习惯用dnf，把它替换成dnf install加本地文件路径效果相同。
装完看到什么：应用菜单出现 Folia 入口，rpm -q folia-major打印出版本号。
方案三：解压即用，不写系统的便携版
适合其他 Linux 发行版，也适合不想在系统里留任何痕迹的你。
准备：下载folia-major-<版本>-linux-x64.tar.gz。
操作：
解压到固定目录并直接运行，主窗口弹出即成功：
tar -xzf folia-major-<版本>-linux-x64.tar.gz -C ~/Apps/Folia && cd ~/Apps/Folia && ./folia-major可执行文件和
resources/目录必须留在同一目录，拆开就找不到资源，启动直接失败。
装完看到什么：终端里主窗口正常弹出，不黑屏、不闪退。
想要应用菜单入口的话，把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/，再把其中__APP_PATH__、__ICON_PATH__两个占位符替换成可执行文件与图标的实际绝对路径；模板见 packaging/linux/folia-major.desktop，细节见 packaging/linux/README-LINUX.txt。
版本号统一说明：无论走哪个渠道，都以官方 Releases 页面实际展示的版本号为唯一标准，其余渠道的版本可能落后。
装完怎么算成功
先对肉眼信号：Windows 看桌面快捷方式；macOS 看「应用程序」里的Folia；.deb/.rpm用dpkg -s folia-major或rpm -q folia-major查状态；便携版在终端跑which folia-major能看到路径就算注册成功。
信号全绿还不算完，要真正触发一次核心功能：添加本地音乐目录，或登录一个在线音源，点开任意一首歌按播放，全屏歌词动画随节奏渲染出来，才算装好。
按现象排错
启动后黑屏、透明异常
原因是 GPU 渲染路径不兼容。解法分两档，先软后硬：
FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major仍不稳定的话，切到最保守的软件渲染：
FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major窗口不再黑屏、透明度恢复正常就算修好；恢复常规运行把该变量去掉即可。更多兼容细节见 packaging/linux/README-LINUX.txt。
提示「Folia.app 已损坏 / 无法验证」
原因是当前发布没有 Apple Developer ID 签名，下载文件的隔离属性被 Gatekeeper 拦截，并不是包坏了。先把应用拖进「应用程序」，再执行：
xattr -dr com.apple.quarantine /Applications/Folia.app然后从「应用程序」重新打开。能正常启动就算修好；之后每次覆盖安装新版本，隔离属性会重新附上，这条命令需要再执行一次。完整流程见 docs/desktop/macos-app-damaged.md。
AUR 构建一直卡在下载环节
不是构建失败，是在线拉包太慢。手动下载与 PKGBUILD 里pkgver同版本的folia-major-<版本>-linux-x64.tar.gz，放进构建源码目录后再执行makepkg -si，它会跳过在线下载继续构建。
装好的 Folia 里放一首歌，全屏歌词立刻铺满屏幕，这趟安装到此收工 🎵
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
