Folia 国内下载完整指南：按系统选路线，四种环境一次讲清

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

GitHub Releases 直连在国内拉包很慢，Folia 国内下载不用硬等。本文按系统和发行版给出对应路线，先判断再动手，每步都能直接照做。

按系统选路线：20 秒判断表

环境对上了就跳对应小节，每节都按「前置条件 → 操作步骤 → 验收标准」三段走。

Windows 与 macOS：官方网盘下载步骤

前置条件：打开 README.md 的「直接下载」小节，官方夸克与百度网盘入口就在这里。安装只认这里的入口，来路不明的第三方转发包一律别碰。

操作步骤：登录网盘客户端，把目标包转存进自己空间后再下载；Windows 对应.exe，Apple silicon 的 macOS 对应.dmg，百度网盘输入提取码 🔑flia。安装全程点默认项即可，桌面版自身带了前后端运行环境。

验收标准：启动后能看到全屏歌词画面，就表示环境没问题。

版本核对：网盘镜像同步存在延迟，包可能旧于最新版；对照 README「直接下载」小节标注的版本号，以那里为准。💡

Linux 便携版怎么跑起来

前置条件：网盘只放 Windows 与 Apple silicon 的包，Linux 要去 Releases 页面取folia-major-<版本>-linux-x64.tar.gz（当前最新 0.7.20），下载慢就挂着慢慢跑。

操作步骤：把包解到一个长期保留的目录，运行其中的folia-major可执行文件即可启动。要进应用菜单的话，将包内resources/linux/folia-major.desktop拷至~/.local/share/applications/，并替换文件里的__APP_PATH__、__ICON_PATH__两处占位符——前者填可执行文件的绝对路径，后者填resources/linux/icon.png的实际路径，改法示例见 packaging/linux/README-LINUX.txt。

验收标准：应用菜单出现 Folia 图标，或在解压目录执行./folia-major弹出窗口，满足其一即可。

排障：若启动黑屏，或透明度、模糊表现异常，多为显卡渲染兼容问题，改用FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major启动。🔧

Arch Linux 的 AUR 安装流程

前置条件：装好 AUR helper（yay、paru 均可）；手上没有的话，先从 AUR 目录自行构建一个。

操作步骤：执行yay -S folia-major-bin，paru 用户把命令里的 yay 换成 paru；alsa-lib、gtk3、libxss、nss等依赖由构建过程自动解决。装完程序落在/opt/folia-major，菜单启动项随包生成，构建逻辑与版本同步细节见 PKGBUILD 与 update.sh。

验收标准：运行pacman -Qs folia-major-bin，输出里出现包条目且版本号与 Releases 一致，安装即告成功。

排障：构建卡在下载压缩包这一步时，提前把同版本 tar.gz 放进构建源码目录，再执行makepkg -si。

路线选定后照着三段走就行，装完看到全屏歌词动起来，这事就算办完了。

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