企业官网建设流程全解析

从下载到跑通：Folia 全屏歌词播放器多系统安装手册（附验收清单与排错表）

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

Folia 是一款以全屏沉浸式歌词动画为核心的播放器，支持本地音乐库与网易云、QQ 音乐、酷狗等在线源。本文带你从下载走到跑通，覆盖 Windows、macOS 与 Linux 的安装路线，装完即可上手，每条路线约 5 分钟。

装前核对：包名先对再下载

当前正式版为0.7.23。各平台包名规律固定，下载后对照文件名里的版本号核对：

对不上就是拿错了包。

环境与权限要求：

• Windows / macOS：无前置
• Arch / Manjaro：已装 yay 或 paru
• deb / rpm 路线：sudo 权限
• 便携版：无

更新分 Realeco 正式、Limo 夜更、Cielo 金丝雀三个通道，新手认准latest标签下的正式版即可，通道差异见技术与开发说明。

选路 · 三问

你在什么系统上？Windows、macOS 走「安装程序 / dmg」两条路线；Arch、Manjaro 走 AUR；Debian、Ubuntu、Linux Mint 装 deb；Fedora、RHEL、openSUSE 装 rpm；其他发行版用便携版。

网络能否直连官方源？国内网络直连 GitHub Releases 经常限速或中断。Windows 与 Apple silicon 可以改走 README「快速下载」一节的网盘入口；Linux 包没有网盘，只能直连。

要正式安装还是便携运行？正式安装给你菜单项或系统命令；便携版解压即用，删掉目录即卸载。

路线一 · Windows：装安装程序

目标：装完开始菜单出现 Folia，点开弹出主窗口。

步骤

1. 打开 README「快速下载」一节的网盘入口（只收正式版），核对版本号后选安装程序。Folia-Setup-0.7.23.exe
2. 双击安装程序，向导有中文界面，安装位置可改，一路下一步装完。
3. 点开始菜单里的 Folia 快捷方式启动。

最容易踩的坑：网盘镜像可能滞后一个版本，选包前对照官方页版本号，别拿到旧包。

验收信号：开始菜单和桌面都有 Folia 快捷方式，点击后主窗口正常打开、不是黑屏。

路线二 · macOS：拖拽 dmg 安装

目标：Folia 落在「应用程序」里，从那里启动不报错。

步骤

1. 从 README 网盘入口或官方 Releases 选包，Apple silicon 用 arm64，Intel Mac 用 x64。Folia-0.7.23-arm64.dmg
2. 把Folia.app从 dmg 拖进「应用程序」，别在挂载盘里直接运行。
3. 首次打开提示「已损坏 / 无法验证」时，在终端执行：xattr -dr com.apple.quarantine /Applications/Folia.app
4. 从「应用程序」重新打开。

最容易踩的坑：当前版本没有 Apple Developer ID 签名，隔离提示是正常拦截，移除隔离属性即可，详见macOS「已损坏」说明。

验收信号：「应用程序」里能看到 Folia，从那里启动不弹任何报错。

路线三 · Arch / Manjaro：AUR 一条命令装好

目标：系统里多出folia-major命令和应用菜单项。

步骤

1. 确认 AUR helper 可用（用 paru 的换成paru --version）。yay --version
2. 一条命令安装，构建会自动从 Releases 拉同版本 tar.gz，并带上alsa-lib、gtk3、libxss、nss四个依赖。yay -S folia-major-bin
3. 验证命令路径。which folia-major

最容易踩的坑：AUR 条目版本可能落后于最新 Releases，构建卡在 tar.gz 下载时，把手动下好的同版本压缩包放进构建源码目录再跑makepkg -si跳过慢速下载。

验收信号：which folia-major输出/usr/bin/folia-major，应用菜单里多出 folia-major 启动项。

路线四 · Debian / Ubuntu：安装 deb 包

目标：系统里登记 folia-major 包，应用菜单出现启动项。

步骤

1. 从官方 Releases 页下载 deb 包。folia-major-0.7.23-linux-x64.deb
2. 安装：sudo dpkg -i folia-major-0.7.23-linux-x64.deb
3. 若提示依赖缺失，补一句：sudo apt -f install

最容易踩的坑：dpkg 不自动拉依赖，缺依赖提示属正常现象，别删包重装，sudo apt -f install一次补齐即可。

验收信号：dpkg -s folia-major状态显示install ok installed，应用菜单出现启动项。

路线五 · Fedora / RHEL / openSUSE：安装 rpm 包

目标：系统里登记 folia-major 包，应用菜单出现启动项。

步骤

1. 从官方 Releases 页下载同版本 rpm 包。folia-major-0.7.23-linux-x64.rpm
2. 带./前缀安装，让 dnf 走本地文件：sudo dnf install ./folia-major-0.7.23-linux-x64.rpm

最容易踩的坑：漏掉./前缀，dnf 会去在线仓库找包并报「找不到」。

验收信号：rpm -q folia-major能打印出folia-major-0.7.23。

路线六 · 其他 Linux 发行版：跑通便携 tar.gz

目标：解压即可运行，不动系统，删目录即卸载。

步骤

1. 下载便携版压缩包。folia-major-0.7.23-linux-x64.tar.gz
2. 解压到任意目录，例如~/Apps/Folia。tar -xzf folia-major-0.7.23-linux-x64.tar.gz -C ~/Apps/Folia
3. 进入该目录直接运行。./folia-major
4. 想加桌面项，把resources/linux/folia-major.desktop复制到~/.local/share/applications/，将__APP_PATH__、__ICON_PATH__两个占位符替换为绝对路径，模板细节见仓库packaging/linux/README-LINUX.txt。

最容易踩的坑：启动黑屏、透明度异常或闪退是 GPU 渲染路径问题，切软件渲染：FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major，仍不稳改用FOLIA_LINUX_GRAPHICS_MODE=software。

验收信号：终端不报错、弹出 Folia 主窗口，即代表便携包可用。

跑通验收：装上了 ≠ 装好了

按顺序走三步，全过才算真正跑通：

1. 主窗口正常打开——界面可见，不是黑屏。
2. 连上一个真实数据源——导入本地音乐文件夹，或登录一个在线源。
3. 播一首歌，看歌词动画——全屏歌词随节奏渲染出来，走到这一步安装才算真正完成 ✅

当歌词开始在屏幕上动起来，你就从「装完」变成「会用」了：挑一个喜欢的歌词动画，剩下的交给音乐。

故障速查表

下一步

三步验收全绿，Folia 才算真正属于你。进「本地音乐库」导入第一个文件夹，或登录在线源点开第一首歌，完整导入、重扫与匹配流程见本地音乐库管理 🎵

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