Folia 下载与安装：从选对安装包到 5 分钟点亮全屏歌词
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是一款开源音乐播放器，主打让歌词以全屏动态画面的形式跟着旋律动起来，QQ 音乐、网易云、酷狗等在线音源、Navidrome 和本地音频文件夹都能接进来。这篇 Folia 下载与安装指南按系统分路线走：先花 30 秒搞清楚该下哪个包，再跟着对应章节点完最后一步。
30 秒对号入座：按系统和芯片选对安装包
各平台的包都集中在 Releases 页面，文件名里写死了系统和架构，照下表挑就行。注意架构标识要和机器一致，x64 与 ARM 的包不通用。
| 你的机器 | 拿哪种包 | 文件名长这样 |
|---|---|---|
| Windows（64 位） | 安装向导 | Folia-Setup-版本号.exe |
| Apple 芯片 Mac（M1、M2、M3…） | 磁盘镜像 | Folia-版本号-arm64.dmg |
| Intel 芯片 Mac | 磁盘镜像 | Folia-版本号-x64.dmg |
| Linux x86_64 | 压缩包（另有 .deb / .rpm） | folia-major-版本号-linux-x64.tar.gz |
💡 国内网络直连 Releases 下载经常偏慢：README.md 的「快速下载」一节给了夸克网盘和百度云盘的镜像入口，但镜像只覆盖 Windows 与 Apple 芯片 Mac 的正式版，Linux 包没有镜像，只能走 Releases。另外镜像偶尔比官方版本落后一拍，拿到手先对一眼版本号再开工。
Windows：双击 exe，把向导点完
- 从 Releases 页面拿
Folia-Setup-版本号.exe，下载前和页面标注的最新版本号对一眼。 - 双击运行。向导自带中文界面，安装位置用默认即可，也可以自己指一个磁盘。
- 一路点到底，桌面和开始菜单都会生成 Folia 快捷方式，点一下进主界面。
安装包把运行环境整个打了进去，机器上不用预装 Node.js 之类的开发工具，双击就能用。
macOS：挪进 Applications，还要解除一次"隔离"
- 打开下载的
Folia-版本号-arm64.dmg（Intel 机器拿 x64 那份），把挂载窗口里的 Folia.app 挪到 Applications 目录。别在挂载窗口里直接运行。 - 首次启动大概率被 Gatekeeper 拦下，弹「Folia.app 已损坏，无法打开」。
- 这不是包坏了：当前发布的 macOS 版本还没有 Apple Developer ID 签名与公证，浏览器下载会带上隔离属性，未签名应用就被拦成"已损坏"的提示。在终端跑一条命令即可：
移除下载隔离属性，之后从 Applications 重新打开
xattr -dr com.apple.quarantine /Applications/Folia.app- 执行完回到 Applications 再启动一次，就进去了。macOS 版暂不支持应用内自动更新，以后每次覆盖安装新版本，这条命令都要再跑一遍。
如果弹的是别的拦截文案（比如只有"无法验证"），仓库里有针对各种提示的完整处理办法：docs/desktop/macos-app-damaged.md。
Linux：解压即跑，Arch 下一条命令装好
通用发行版（Ubuntu、Debian、Fedora 等）
- 从 Releases 拿
folia-major-版本号-linux-x64.tar.gz（用 .deb / .rpm 的发行版可以直接装对应文件），解压到任意目录，直接运行里面的folia-major可执行文件。 - 想让应用菜单里也有入口：把包内
resources/linux/folia-major.desktop复制到~/.local/share/applications/，再把文件里的__APP_PATH__和__ICON_PATH__两个占位符替换成可执行文件与图标的实际路径；桌面环境若要求，把文件标记为可信。
包结构、替换示例和图形兼容细节都写在 packaging/linux/README-LINUX.txt。
Arch Linux：AUR 预构建包
安装 AUR 预构建包（用 paru 的话，把命令里的 yay 换成 paru）
yay -S folia-major-binalsa-lib、gtk3、libxss、nss等依赖由 AUR 自动解决，程序落在/opt/folia-major，启动命令就是folia-major。有一点要留意：PKGBUILD 里固定的版本号可能落后于 Releases 的最新发布，装完记得核对，清单在 packaging/aur/folia-major-bin/PKGBUILD。
⚠️ 启动后黑屏、透明度异常或闪退，多半是显卡兼容问题，不是装坏了。先用软件渲染启动一次验证；还不稳定就改用
software值，确认没事后可以用system恢复系统图形路径。
以软件渲染方式启动，排除显卡兼容问题
FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major打开后的两件事：核对版本号、放一首有歌词的歌
- 对版本：打开应用内的「关于」页，把显示的版本号和下载文件名里的版本号比一下，一致才算装对；对不上说明拿错了包或镜像没同步，回 Releases 重新下，别将就旧版。
- 放一首歌：登录任一个在线音源，或者选一个本地音频文件夹导入曲库，随便点一首有歌词的歌，全屏歌词动画会自动亮起。再进设置换两三个主题试试，每个主题的排版氛围差很多。
想在浏览器或 NAS 里用 Folia
桌面版之外也有 Web 形态：Vercel 或 Cloudflare 一键部署，或者用 Docker Compose 自托管（见仓库 deploy/docker/ 目录的说明），部署后在手机浏览器里「添加到主屏幕」就能当 PWA 用。这条路线要跑命令行、配环境变量，门槛比装桌面版高，想试的从部署文档入手即可。
下一步：按第一节的表格确认你拿对了包，然后进入对应系统那一节把剩余步骤走完；装完先做「打开后的两件事」，全屏歌词亮起来才算真正收尾。
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
