Folia 歌词动画播放器完整安装指南：Windows、Mac、Linux 一次装好-育师

Folia 歌词动画播放器完整安装指南：Windows、Mac、Linux 一次装好

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

Folia 是一款基于 Electron 的全屏歌词动画播放器，能播本地曲库、Navidrome 服务器，也直连网易云、QQ 音乐、酷狗等在线音源。这篇文章从下载入口讲到首次播放出动效歌词，带你一次把安装流程走完，全程只给能直接执行的动作。

装完你能得到什么

打开 Folia 后，主窗口顶部是搜索栏，中间是专辑卡片墙。点任意一首歌即可播放，歌词立刻切到全屏动画舞台，随进度逐行推进。只要能看到这样的播放页并正常出歌词，安装就算成功，逐项核对见文末的验收一节。

动手前：先按系统对好下载文件

官方安装包分四路，先确认自己拿哪个：

Windows 拿Folia-Setup-<版本>.exe；
Apple 芯片 Mac 拿Folia-<版本>-arm64.dmg；
常见 x64 Linux 发行版（Debian、Ubuntu、Fedora 等）拿folia-major-<版本>-linux-x64.tar.gz，解压即用的便携版；
Arch Linux 走 AUR 包folia-major-bin，由包管理器构建，不用自己下压缩包。

下载地址看仓库 README 的「快速下载」小节。国内网络可走夸克或百度网盘镜像（提取码flia），⚠️ 网盘只收录 Windows 与 Apple Silicon 两个正式版，Linux 用户必须用 Release 里的便携版，下载前先核对版本号一致。

三步走完：下载、安装、首次启动

下载对应文件，网盘用户建议先转存到自己网盘再下载，断流可续传。完成信号：文件完整落盘。
安装，各平台动作不同：
- Windows：双击.exe，按默认路径一路装完。完成信号：开始菜单出现「Folia」图标。
- Mac：双击 dmg，把 Folia 图标拖进「应用程序」文件夹，不要直接在挂载盘里运行。
- Linux 便携版：解压到一个不会被清理的固定目录，确认folia-major可执行文件和resources/目录仍在同一文件夹。⚠️ 两者缺一个都启动不了。
- Arch：先装一个 AUR Helper（yay 或 paru），再执行yay -S folia-major-bin，alsa-lib、gtk3、libxss、nss等依赖会自动装好。若卡在拉取压缩包，把同版本 tar.gz 放进构建目录的源码目录，再用makepkg -si续上构建。
首次启动：Windows 和 Mac 从开始菜单或 Launchpad 点开；Linux 在便携版目录执行./folia-major；Arch 用pacman -Qs folia-major核对输出里应出现folia-major-bin条目。

完成信号：主窗口弹出，搜索栏与专辑卡片墙齐全，点歌后立刻出现全屏歌词动画。桌面版已内置前后端运行环境，无需再装任何依赖。

顺手把 Linux 桌面启动项也建了：把包内模板复制到~/.local/share/applications/并改名folia-major.desktop，再把文件里的__APP_PATH__、__ICON_PATH__两个占位符替换成真实绝对路径；桌面环境要求时记得把该文件标记为可信。完整示例见 packaging/linux/README-LINUX.txt。

Mac 提示应用已损坏：去掉隔离属性

macOS 首启弹「已损坏」或「无法验证」，是因为当前版本没有 Apple 开发者签名，不是文件坏了。在终端执行下面命令移除下载隔离属性：

xattr -dr com.apple.quarantine /Applications/Folia.app

应用不在 Applications 就把路径改成实际位置。执行后从「应用程序」重新打开即可，两种提示都有效。覆盖安装新版本后隔离属性会回来，需要再执行一次。背景与备选方案见 docs/desktop/macos-app-damaged.md。

Linux 黑屏、GPU 崩溃：切渲染路径

启动后黑屏、透明度或模糊异常、GPU 进程崩溃，先用 swiftshader 软件渲染：

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

仍不稳定再换最保守的纯软件渲染：

FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major

画面稳定后，用FOLIA_LINUX_GRAPHICS_MODE=system切回系统图形路径。⚠️ 这些变量只影响 Electron 的 Linux 启动参数，不改变 Web 端与同步服务配置。

验收：三个信号确认装好了

✅ 满足任意一条即算通过：

主窗口正常打开，看得到搜索栏与专辑卡片，播放歌曲时有全屏歌词动画。
Linux 便携版目录执行./folia-major，弹出带歌词的主窗口。
Arch 上pacman -Qs folia-major输出包含folia-major-bin条目。

装好后：把曲库接进来

接本地音乐：导入本地文件夹，元数据、同目录歌词与封面会自动读取，详见 docs/local-library-management.md。
开壁纸模式：在「选项 → 桌面端」打开「壁纸模式」，主窗口沉到所有窗口之下当桌面歌词壁纸，说明见 docs/wallpaper-mode.md。
自托管 Web 版：Docker Compose 全栈部署，见 deploy/docker/README.md。
想加更多动画：在「设置 → 模组 → 模组系统」开启后，把模组 zip 拖进面板即可安装。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Folia 歌词动画播放器完整安装指南：Windows、Mac、Linux 一次装好