Folia 安装教程：Windows、macOS、Linux 三步装好全屏歌词播放器
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是一款以全屏歌词动画为核心的音乐播放器，支持网易云、QQ 音乐、酷狗等在线音源，也能接入 Navidrome 与本地音乐库。这篇 Folia 安装教程覆盖 Windows、macOS、Linux 三端的下载、安装与启动验证，网络顺畅的情况下，10 分钟左右就能让第一首歌的歌词铺满整块屏幕。
一、📦 兼容性速查：对照系统选对包
| 平台 | 系统要求 | 包格式 | 推荐下载渠道 |
|---|---|---|---|
| Windows | 64 位系统 | .exe安装包 | 官方网盘镜像或 GitHub Releases 页面 |
| macOS | Apple silicon（M 系列）或 Intel 芯片 | .dmg | 网盘镜像（仅 Apple silicon 正式版）或 Releases 页面 |
| Linux | x86_64 / ARM（架构需对应） | .tar.gz压缩包 | GitHub Releases 页面（无网盘镜像） |
两点提醒：官方网盘镜像只覆盖 Windows 与 Apple silicon 的正式版，Linux 包和 Intel Mac 包需要走 Releases 页面；另外桌面版已把前后端运行环境打进了安装包，你不需要预先安装 Node.js 或任何开发工具。
二、分平台安装步骤
Folia Windows 安装：选包、下载、启动
- 选包：在 README.md（项目说明文件，「快速下载」一节点出了网盘镜像与 Releases 入口）中挑文件名以
.exe结尾、版本号与最新一致的 installer。 - 下载：走网盘时建议先转存到自己的网盘再取回，中途断了可以续传；如果在 Releases 页面反复慢速或断流，就换镜像渠道。
- 安装：双击下载的
.exe，按向导一路点击完成即可。 - 启动：在开始菜单搜索 Folia，双击进入主界面。
Folia macOS 安装：DMG 三步走
- 选包：先确认芯片——点左上角苹果菜单选「关于本机」。M 系列芯片选 Apple silicon 版
.dmg，网盘镜像恰好只收录这个正式版；Intel 芯片则在 Releases 页面挑 Intel 版。 - 下载：取回前扫一眼文件名里的版本号，确认与 Releases 页面标注的最新值一致。
- 安装：打开
.dmg，把其中的 Folia 图标拖进 Applications 文件夹，安装即完成。 - 启动：在 Launchpad 或应用程序文件夹中搜索 Folia 并打开。
Folia Linux 安装：AUR、便携包与桌面快捷方式三条路线
AUR 构建（Arch 及其衍生版）
先确认系统装有 AUR 助手（yay 或 paru），下面这条命令会从 AUR 下载预构建包并自动解析系统依赖完成安装：
yay -S folia-major-bin构建会自动解析alsa-lib、gtk3、nss等依赖，把程序装到/opt/folia-major并生成应用菜单入口，依赖清单与安装位置可以在 PKGBUILD（AUR 包的构建脚本）中核对。如果构建阶段拉压缩包太慢，可以先从 Releases 页面取回同版本的folia-major-<版本号>-linux-x64.tar.gz，放进 AUR 源码目录后执行makepkg -si。
通用 tar.gz 解压部署（其他发行版）
从 Releases 页面取对应架构的.tar.gz，x86_64 与 ARM 包不通用，注意区分。解压到任意目录即可直接运行，包内含folia-major可执行文件和一个桌面启动项模板。
桌面快捷方式配置
按 README-LINUX.txt（Linux 便携版说明，也收录了图形兼容参数）操作：把包内模板复制到~/.local/share/applications/folia-major.desktop，将__APP_PATH__与__ICON_PATH__两个占位符替换为可执行文件和图标的实际路径，再按桌面环境要求将该文件标记为可信，应用菜单里就能看到 Folia。
三、✅ Folia 安装后 30 秒验收
装完先别关窗口，花半分钟按顺序确认下面几项：
- 打开「关于」页面，核对版本号与刚下载的包一致，对得上才算装成功
- 登录一个在线音源，或导入本地文件夹作为曲库，播放一首带歌词的歌，确认全屏歌词动画正常亮起
- 进入设置依次切换几个主题，确认排版与配色显示无异常
四、高频问题速答
Q：下载慢或反复中断，怎么办？
优先换官方网盘镜像，入口在仓库 README 的「快速下载」一节。记住镜像只覆盖 Windows 与 Apple silicon 的正式版，Linux 包没有镜像，只能走 Releases 页面。镜像偶尔会比官方版本晚一步，装完后务必到「关于」页核对版本，对不上就重新取回最新版。
Q：Linux 上黑屏、透明度异常或闪退？
多数是 GPU 兼容问题，而不是安装坏了。先用软件渲染验证，下面这条命令会强制应用以 swiftshader 软件渲染方式启动，用来排除显卡因素：
FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major仍不稳定就把取值改为
software，这是最保守的软件渲染；确认稳定后也可以用FOLIA_LINUX_GRAPHICS_MODE=system恢复系统图形路径。
Q：装到一半发现拿错了包？
常见于两种情况：Intel Mac 用了 Apple silicon 包，或者 Linux 的 x86_64 / ARM 架构选错。回到 Releases 页面，逐字核对文件名里的平台标识，重新选一次即可。
到这里，Folia 的安装工作就全部结束了。下一步：登录你常用的音源，把第一首歌的歌词点亮整块屏幕吧。
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
