Folia 下载安装教程：从取包到首次启动的完整步骤
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是把歌词渲染成全屏动画的沉浸式音乐播放器，能接网易云、QQ 音乐、Navidrome 与本地音乐库，支持 Windows、macOS、Linux 桌面端，另有 Web 版。这篇 Folia 安装教程带你从取包走到第一次看到启动首页。
动手前 30 秒自检
- 系统：Windows 10/11、macOS（Apple silicon 与 Intel 都有包）或 Linux x86_64，任选其一。
- 网络：能打开项目 Releases 页面（官方发布页）即可；国内网络直连慢没关系，README 的「快速下载」一节备了夸克、百度两个网盘镜像。
- 依赖：桌面版内置运行环境（打包好的自带执行环境），不用预装 Node.js；只有 Arch 用户走 AUR 时需要先配好 yay 或 paru。
- 磁盘：预留约 500MB 空间，安装路径避开中文和空格，省得后面路径报错。
把安装包拿回来
这一步做完，你手上会有一个和当前 Release 版本对应的安装包文件。
- 打开项目 README 的「快速下载」一节，按页面指引进入 Releases 页面。
- 按平台挑文件：Windows 取
.exe安装包，macOS 取.dmg，Linux 取linux-x64的.tar.gz便携包（解压出来就能跑、不用正式安装的压缩包），文件名里一眼就能看出平台。 - 核对版本号：拿包名里的版本段（如
folia-major-0.7.23-linux-x64.tar.gz）对照 Release 列表最新一条，不一致说明你拿到的是旧包，重新取一次即可。
容易踩的坑：网盘镜像目前只提供 Windows 与 Apple silicon Mac 的安装包，Intel Mac 和其他 Linux 用户请以 Releases 页面的正式包为准。
装进系统
这一步做完，系统里会多出一个能直接启动的 Folia 应用。
Windows 安装
- 双击取回的安装包，按向导走完安装。
- 安装目录默认即可，别选到带中文或空格的路径。
- 开始菜单里出现 Folia 条目，代表安装成功。
macOS 安装
- 双击
.dmg，把 Folia 图标拖入 Applications 文件夹。 - 首次启动若被系统拦下，在「系统设置 → 隐私与安全性」里允许一次，这是正常的系统提示，不是病毒警告。
Linux 便携版部署
- 把便携包解压到固定目录：
mkdir -p ~/Apps/Folia tar -xzf folia-major-0.7.23-linux-x64.tar.gz -C ~/Apps/Folia- 把桌面启动项模板复制到应用菜单目录：
cp ~/Apps/Folia/resources/linux/folia-major.desktop ~/.local/share/applications/- 编辑复制出的
.desktop文件，把__APP_PATH__与__ICON_PATH__两处占位符替换为folia-major可执行文件和resources/linux/icon.png的绝对路径（以/开头的完整路径）。 - 桌面环境有要求时把该文件标记为可信，再从应用菜单启动。
省时间技巧：Arch 系发行版用
yay -S folia-major-bin一条命令就能完成下载与部署，paru 用户把 yay 换成 paru 即可。
确认它真的在跑
这一步做完，你能确认 Folia 已经真正跑起来，而不是只装了个壳。
成功的样子有三个信号，占任意一个即可：
- 启动后看到 Folia 首页，顶部可切换在线音源，底部是播放控制条；首次启动会短暂停在加载页，稍等几秒即可。
- 登录网易云等音源后，首页能列出歌曲列表并正常播放。
- 终端里直接敲
folia-major命令可以执行（AUR 或便携部署完成后）。
不用在线音源的话，启动后导入本地音频文件夹，本地音乐库界面会列出导入的歌曲：
三个信号都没占上时，多半是安装或图形驱动的问题，先查下面这张表再深挖。
卡住了？对这张表查
| 现象 | 处理办法 |
|---|---|
| Linux 启动后黑屏、透明度或模糊异常 | 用软件渲染路径启动：FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major |
| swiftshader 下仍闪烁或崩溃 | 换最保守模式：FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major |
| 下载长时间不动 | 暂停后切到 README「快速下载」的网盘镜像（限 Windows / Apple silicon Mac） |
| 网盘里没有对应平台的包 | 回 Releases 页面取对应平台的正式安装包 |
| 桌面快捷方式点了没反应 | 检查.desktop的 Exec / Icon 是否填了绝对路径，并补标记为可信 |
接下来可以读
- docs/technical.md：Linux 图形模式、Wayland 遥控窗等桌面端技术细节。
- packaging/linux/README-LINUX.txt：便携目录结构、桌面启动项与图形变量逐项说明。
- docs/local-library-management.md：本地音乐库的导入、重扫、歌词匹配与歌单管理。
登录任意在线音源或导入本地库，放一首带歌词的歌，全屏动画就跑起来了。
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
