Folia 全屏歌词播放器 10 分钟安装跑通：Windows / macOS / Linux 全路线
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
你在国内网络下从 Releases 直接下载常常慢得没法看，网盘链接散在角落，文档又看不太懂。本文按系统拆成 3 条路径：Windows / macOS 走网盘安装包，Arch 系走 AUR，其他 Linux 走便携版，全程 10 到 15 分钟，把全屏歌词动画跑起来。
装完你手上有什么
- 全屏歌词动画，流光、浮名等多套主题
- 支持网易云、QQ 音乐、酷狗、Navidrome
- 本地音乐库导入，自动匹配歌词封面
- 桌面版内置运行环境，装完即播
- 覆盖 Windows / macOS / Linux，另有 Web 版
30 秒选路：哪条道适合你
| 路径 | 适配系统 | 难度 | 耗时 |
|---|---|---|---|
| 网盘镜像 | Windows / macOS（Apple silicon） | ★☆☆ | 5 分钟 |
| AUR 一条命令 | Arch / Manjaro 等 AUR 系 | ★★☆ | 10 分钟 |
| 便携版解压即用 | 其他 Linux 发行版 | ★★☆ | 10 分钟 |
💡 Windows / macOS 用户直接去「按系统走」对应小节；Arch / Manjaro 用户去「Linux」小节的「AUR 系」；其他发行版走「其他发行版」。网盘可能滞后于官方发布，动手前先核对 package.json 里的版本号（当前 0.7.23）。
按系统走
Windows
拿：打开仓库 README.md 的「快速下载」一节，找到官方网盘链接（夸克、百度，百度提取码flia），挑 Windows 的.exe安装包。
装：
- 打开网盘链接，把安装包转存
- 下载
.exe文件 - 双击安装器，跟着提示装完
验：双击启动，主界面弹出且无黑屏。
macOS
拿：同一个「快速下载」网盘入口，挑 Apple silicon 版的.dmg；Intel 机器去仓库 Releases 页找对应安装包。
装：
- 打开网盘链接，转存
.dmg - 双击
.dmg，把 Folia 拖进应用程序 - 从应用程序文件夹启动 Folia
验：启动后主界面弹出。
Linux
AUR 系
拿：包名folia-major-bin，需预装yay或paru等 AUR 助手。
装：
- 执行下面命令，等构建完成
yay -S folia-major-bin构建会自动解析alsa-lib、gtk3、nss等依赖，应用落在/opt/folia-major，并生成folia-major命令与菜单启动项。
验：终端输入folia-major回车，主界面弹出。
其他发行版（便携版）
拿：官方 Releases 页最新版folia-major-<版本>-linux-x64.tar.gz；国内慢的话先用网盘里的同版本压缩包。
装：
- 解压 tar.gz 到自选目录
- 把
.desktop模板复制到~/.local/share/applications/目录 - 替换文件里
__APP_PATH__与__ICON_PATH__两个占位符为实际路径
验：在解压目录执行./folia-major，主界面弹出。完整步骤见 packaging/linux/README-LINUX.txt。
装完三件事，确认它真的跑起来了
上面三个系统小节只保证你启动成功，要确认真的跑起来，再按顺序做这三件事：
启动主界面→ 窗口弹出，无黑屏、无透明度异常切一首带歌词的歌→ 全屏歌词动画跟着歌词逐行播放在线搜索点一首→ 网易云 / QQ 音乐搜索出歌能播，歌词封面自动加载
卡住了？对照这张表
| 现象 | 大概率原因 | 一条解法 | 备注 |
|---|---|---|---|
| 启动后黑屏、透明度异常或 GPU 崩溃 | 系统图形路径与应用不兼容 | FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major | 仍不稳定改software |
| AUR 构建卡在 tar.gz 下载或提示 404 | AUR 包版本落后官方最新版 | 网盘拿同版本压缩包放进构建目录后makepkg -si | 先核对版本号 |
| 其他发行版应用菜单里没有启动项 | .desktop没装好或占位符没替换 | 检查文件位于~/.local/share/applications/且两个占位符已替换 | 桌面环境要求时标记为可执行 |
| 网盘里的版本比预期旧 | 网盘镜像滞后于官方发布 | 到 Releases 页比对版本号后再决定是否覆盖替换 | 网盘只有正式版，beta 走 Releases |
装完之后
下载只是开始——打开 Folia，切一首有歌词的歌，把全屏歌词动画拉满，沉浸听歌。想换更多动画风格，实验性的 Folium 模组系统还等你在设置里点亮。🎵
- deploy/docker/README.md：Docker 自托管 Web 版
- docs/technical.md：技术架构与桌面端细节
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
