企业官网建设流程全解析

Folia 安装教程：三种路线装好全屏歌词播放器

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

Folia 是一款把歌词渲染成全屏动画的播放器，支持本地音乐、Navidrome 和网易云、QQ 音乐、酷狗等在线音源。读完这篇，你手上会有一套装好的 Folia 桌面端或 Web 端，并知道从哪一步开始播第一首歌。全程耗时大致在 10 到 30 分钟，取决定于你走哪条路线、网络是否顺畅。

先选路线

先回答三个问题，答案直接对应下面的路线：

1. 什么系统？Windows、Apple silicon 的 Mac，还是 Linux？
2. 要不要碰终端？只想点按钮，还是能接受敲一条命令？
3. 网络能否直连 GitHub Releases？连不上就准备走国内网盘镜像。

结论：只想点按钮的走 A；Arch 系用户走 B，一行命令最省心；其他 Linux 发行版走 C，解压即用。

💡 网盘镜像只覆盖 Windows 与 Apple silicon 的正式版安装包。Linux 压缩包和 Intel Mac 包请走 Releases 下载。

桌面安装包路线：Windows 与 macOS 三步跑完

这条路适合不想碰终端、希望装完就能听歌的你。

1. 打开仓库 README.md，定位「快速下载」一节的官方网盘入口。找到入口，说明你站在正版来源上，不是来路不明的转发包。
2. 下载前先记下文件名里的版本号，再挑选系统对应的包：Windows 选.exe，macOS 选.dmg。版本号记下来，等会儿验收要用。
3. 双击安装包，跟着向导一路下一步直到完成。应用列表里出现「Folia」图标，说明没装错。

Arch Linux 一行命令装完（AUR）

这条路适合 Arch、EndeavourOS 用户，代价是构建时要联网拉一次压缩包。

1. 确认终端里能跑yay或paru，跑不了就先装 AUR Helper。
2. 执行安装命令，paru 用户把yay换成paru：

yay -S folia-major-bin

3. 等构建完成，依赖（alsa-lib、gtk3、nss等）会自动装好，程序落到/opt/folia-major，应用菜单生成folia-major入口。构建从 Releases 拉取压缩包，网速慢时会明显变长；这时可先手动下好同版本folia-major-<版本>-linux-x64.tar.gz放进源码目录，再执行makepkg -si。依赖清单和安装位置见 PKGBUILD。

Linux 便携版路线：解压即用的桌面启动项

这条路适合除 Arch 系以外的 Linux 发行版，不用装任何构建工具。

1. 去 Releases 页面下载folia-major-<版本>-linux-x64.tar.gz，解压到一个你常放的目录，比如~/Apps/Folia。
2. 确认解压出来的目录里有folia-major可执行文件和resources/linux/子目录。目录结构对得上，说明包完整。
3. 把resources/linux/folia-major.desktop复制到~/.local/share/applications/，把模板里的__APP_PATH__、__ICON_PATH__占位符替换为实际绝对路径，再按桌面环境要求把文件标为可信。详细步骤见 packaging/linux/README-LINUX.txt。

验收：首次启动核对清单

1. 从应用菜单（Windows 下是开始菜单）启动 Folia，窗口正常打开，不是黑屏。
2. 在「关于」或设置页查看版本号，与下载时记下的版本号一致。
3. 曲库二选一：登录一个在线音源，或导入一个本地音乐文件夹。
4. 设置里切一个歌词动画主题，确认可正常切换。
5. 播放一首带歌词的歌。歌词铺满整屏并随进度移动，说明 Folia 安装成功。

装好后的 Folia 全屏歌词动画长这样：

导入本地曲库后的界面：

救急：四个高频坑

• 症状：Linux 启动黑屏、透明度异常或闪退 →最可能原因：GPU 兼容问题 →一个动作：先跑FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major验证；仍不稳定再换software模式。
• 症状：下载中断或慢得离谱 →最可能原因：直连 GitHub Releases 的带宽问题 →一个动作：换国内官方网盘镜像，入口以 README.md「快速下载」一节为准。
• 症状：桌面启动项不出现 →最可能原因：__APP_PATH__、__ICON_PATH__占位符没替换成绝对路径 →一个动作：按 packaging/linux/README-LINUX.txt 里的示例改路径，再标可信。
• 症状：网盘包比最新发行旧 →最可能原因：镜像同步滞后 →一个动作：以 Releases 页版本号为基准，对不上就等网盘同步或改走直连。

导入本地文件夹或登录在线音源后，第一首歌就能让全屏歌词亮起来。下一步去设置里挑一个顺眼的歌词动画主题，装好的 Folia 就正式跑起来了。

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