企业官网建设流程全解析

Folia 全屏歌词动画播放器安装指南：零基础到跑通的完整五步

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

Folia 是一款以全屏歌词动画为核心的音乐播放器，支持本地音乐库、Navidrome 以及网易云、QQ 音乐等在线音源。这篇教程带你从选对安装包开始，走完安装、启动、播放验证的完整流程，覆盖 Windows、macOS 与 Linux 的全部安装路径，读完照着做即可。

先把目标版本定下来

本节帮你花半分钟锁定该下载哪个文件，后面每一步都围绕这个文件展开。判断逻辑很简单，对号入座即可：

• 如果你的系统是Windows，就要下Folia-Setup-<版本>.exe安装向导。
• 如果你是macOS 的 Apple M 芯片，就要下Folia-<版本>-arm64.dmg；Intel 芯片则下x64后缀的 dmg。
• 如果你是Arch / Manjaro，不用手动下文件，直接装 AUR 包folia-major-bin，构建时自动从 Releases 拉取tar.gz。
• 如果你是Debian / Ubuntu / Linux Mint系，要下.deb包；Fedora / openSUSE系，要下.rpm包。
• 其余 Linux 发行版，一律用tar.gz便携版兜底。

动手前 30 秒自检

下载前把下面三个信息核一遍，可以避免 90% 的装错版本问题：

• macOS 芯片型号：「关于本机」里看，Apple M 系列对应arm64，Intel 对应x64，选错包装不上。
• Linux 发行版家族：Ubuntu、Linux Mint 属 Debian 系，Fedora、openSUSE 属 RPM 系，Arch、Manjaro 属 Arch 系——包格式跟着家族走。
• 下载源是否直连：能正常打开官方 Releases 页面并下载文件，就优先从那里取全平台包；直连不畅时，夸克 / 百度网盘分享（提取码flia）只有Windows与Apple 芯片 macOS两个版本的包，且版本号可能比最新的一档旧。

桌面端：Windows 与 macOS 的安装步骤

这两台机器上 Folia 都是「图形界面一路点下去」的装法，不用碰命令行，重点在选对包和放对位置。

Windows 安装包：解压后双击运行向导

去哪下载：从网盘分享（提取码flia）里找Folia-Setup-<版本>.exe，版本号以官方 Releases 页面展示的最新为准；如果 Releases 能直连，直接在那下载。

怎么装：建议先把分享链接转存到自己网盘再下载，速度更稳。拿到 exe 后双击，安装向导一路下一步，默认目录或自选目录都可以。

装完长什么样：开始菜单和桌面各出现一个 Folia 快捷方式，双击能弹出主窗口就算成功。

专属坑点：如果网盘里的版本比 Releases 落后一档，直接从 Releases 下新 exe 覆盖安装即可，不必先卸载旧版。

macOS 的 dmg：拖进应用程序文件夹

去哪下载：Apple 芯片下Folia-<版本>-arm64.dmg，Intel 下x64版本；网盘只有 Apple 芯片版，Intel 用户请走 Releases。

怎么装：双击 dmg 挂载出安装窗口，把窗口里的Folia.app拖进「应用程序」文件夹。

装完长什么样：启动台和「应用程序」里都能看到 Folia，图标正常显示即可。

专属坑点：不要在挂载的 dmg 窗口里直接运行——弹出镜像后正在跑的应用会立刻崩溃；首次打开弹出安全提示属正常现象，处理方法见文末「遇到问题先看这里」。

Linux 端：按发行版选对包

Linux 的包格式各不相同，装法也随之分四条线，每条线内部都是「下载 → 装 → 验证 → 避坑」四步。

Arch / Manjaro：一条 AUR 命令装完

去哪下载：不用手动下，AUR 社区仓库里的folia-major-bin包会在构建时自动从 Releases 拉取同版本的tar.gz。

怎么装：先确认助手工具可用，yay --version能打印版本号即可；没有就按 Arch 官方 wiki 先装好yay或paru，然后执行：

yay -S folia-major-bin

装完长什么样：程序落在/opt/folia-major，同时注册了folia-major命令和桌面菜单项，应用菜单里能找到入口。

专属坑点：构建依赖alsa-lib、gtk3、libxss、nss四个包，助手会自动处理；完整的拉包与构建规则见 packaging/aur/folia-major-bin/PKGBUILD。

Debian / Ubuntu 系：.deb 包的安装命令

去哪下载：从官方 Releases 页面下载folia-major-<版本>-linux-x64.deb。

怎么装：dpkg只负责解包注册，不处理依赖，所以命令分两条：

sudo dpkg -i folia-major-<版本>-linux-x64.deb

如果末尾提示缺少依赖，再补一条让apt自动补齐：

sudo apt -f install

装完长什么样：系统应用菜单里出现 folia-major 入口，点开能启动。

专属坑点：不要跳过第二条命令——只跑dpkg -i而忽略依赖提示，启动时大概率直接报错退出。

Fedora / openSUSE 系：.rpm 包的一条命令

去哪下载：从官方 Releases 页面下载folia-major-<版本>-linux-x64.rpm。

怎么装：dnf会自动解析并安装依赖，一条命令搞定：

sudo dnf install ./folia-major-<版本>-linux-x64.rpm

装完长什么样：应用菜单里出现入口，正常打开主窗口。

专属坑点：命令开头的./不能省，它告诉dnf这是一个本地文件而不是仓库里的包名，漏写会去远程仓库找同名包然后失败。

其他发行版：tar.gz 便携版解压即用

去哪下载：从官方 Releases 页面下载folia-major-<版本>-linux-x64.tar.gz。

怎么装：解压到一个固定目录（如~/Apps/Folia/），然后在解压目录里直接运行二进制文件：

~/Apps/Folia/folia-major

装完长什么样：终端不报错、主窗口正常弹出而非黑屏，便携版就算跑起来了。

专属坑点：可执行文件和resources/目录必须留在同一个解压目录里，拆开放会因找不到资源启动失败。想加菜单项的话，把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/，再把其中__APP_PATH__、__ICON_PATH__两个占位符替换为可执行文件和图标的实际绝对路径，模板见 packaging/linux/folia-major.desktop。

装完怎么确认真的能用

先看各平台的肉眼信号，Windows 是快捷方式能启动，macOS 是启动台能打开，Linux 是菜单入口或终端运行不报错。再走一步端到端验证才算数：

添加一个本地音乐目录，或登录网易云、Navidrome 等任意在线音源，点开任意一首歌按播放——全屏歌词动画随节奏渲染出来，说明安装真正生效。

习惯终端的话，再补一两条命令行终验：

• AUR 路线：which folia-major打印出/usr/bin/folia-major，说明命令已注册。
• Debian 系：dpkg -s folia-major状态一栏显示install ok installed。
• RPM 系：rpm -q folia-major打印出版本号。

遇到问题先看这里

Linux 启动出现黑屏或透明度异常

现象：窗口弹出来全黑，或透明、模糊效果不对劲。

原因：多半是当前显卡的图形渲染路径和 Electron 不兼容。

解决：先用软件光栅化启动一次：

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

仍不稳定就切到最保守的软件渲染：

FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major

该变量只改 Linux 启动参数，不动其他配置，更多兼容细节见 packaging/linux/README-LINUX.txt。

macOS 提示 Folia.app 已损坏

现象：首次打开弹出「应用已损坏，无法验证开发者」。

原因：当前发布没有 Apple Developer ID 签名，下载文件自带的隔离属性被 Gatekeeper 拦截，并不是包坏了。

解决：先把应用拖进「应用程序」，再在终端执行：

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

执行完从「应用程序」重新打开即可；每次覆盖安装新版本后隔离属性会重新附上，需要再跑一次，完整流程见 docs/desktop/macos-app-damaged.md。

AUR 构建一直卡在下载环节

现象：yay -S长时间停在「下载」进度上不动。

原因：在线拉取tar.gz网速太慢，不是构建失败。

解决：手动下载与 PKGBUILD 中pkgver版本号一致的folia-major-<版本>-linux-x64.tar.gz，放进构建源码目录后重新执行makepkg -si，它会跳过在线下载继续构建。

网盘里的包和最新版对不上

现象：网盘包的文件名版本号比官方 Releases 页面展示的旧。

原因：网盘是某个时点的存档，不随每次发版同步。

解决：以 Releases 页面实际展示的版本号为唯一标准，确认要装的版本后直接下对应文件；网盘仅在没有直连条件时使用。

当歌曲播起来、歌词铺满整块屏幕的那一刻，这次安装就正式完成了，接下来就是享受 🎵

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