洛雪音乐分为桌面版（基于 Electron & Vue）和移动版，分别支持不同的操作系统。本教程将介绍各平台的安装方法与注意事项。

请通过 https://www.lxmusic.cn/download/ 进行下载安装。

Windows 安装

Windows 版本提供两种安装包：

  • 安装版（Setup.exe）：双击运行安装程序，按提示完成安装。安装版支持自动更新，软件启动时会自动检测新版本并下载安装。推荐大多数用户使用。
  • 免安装版（green.7z）：使用 7-Zip 等解压软件解压后，直接运行其中的 lx-music-desktop.exe。免安装版不会注册到系统，但无法自动更新。

从 v2.5.0 起，Windows 版默认不再支持 Windows 7/8/8.1。如需在这些系统上使用，请下载文件名带 win7 的免安装版，但该版本缺乏安全更新，不建议非必要使用。

免安装版以 .7z 结尾，需要解压缩软件。推荐使用 7-Zip 或 Bandizip。

macOS 安装

  1. 根据你的 Mac 芯片类型下载对应的 .dmg 文件：Intel 芯片选择 x64 版本，Apple Silicon（M1/M2/M3）选择 arm64 版本。
  2. 双击打开 .dmg 文件。
  3. 将洛雪音乐图标拖入「Applications」文件夹。
  4. 在「启动台」中找到洛雪音乐并打开。

首次打开时如果提示「无法验证开发者」，请前往「系统设置 → 隐私与安全性」，点击「仍要打开」。

Linux 安装

Linux 版本提供多种格式：

  • .deb：适用于 Debian、Ubuntu 等基于 Debian 的发行版。使用命令 sudo dpkg -i 文件名.deb 安装。
  • .rpm：适用于 Fedora、CentOS 等基于 RPM 的发行版。使用命令 sudo rpm -i 文件名.rpm 安装。
  • .AppImage：无需安装，赋予执行权限后直接运行：chmod +x 文件名.AppImage && ./文件名.AppImage
  • .pacman：适用于 Arch Linux 等使用 pacman 的发行版。

Android 安装

  1. 前往下载页面，点击 Android 版下载按钮获取 .apk 安装包（统一版本，无需选择架构）。
  2. 在手机上找到下载的 APK 文件，点击安装。
  3. 如提示「未知来源应用」，请在系统设置中允许安装。

版本号包含 sl 的安装包为「墨·状态栏」特别版，支持状态栏歌词功能。目前没有计划支持 iOS 和 HarmonyOS NEXT。

安装失败怎么办

如果安装过程中遇到问题，可以尝试以下方法：

  • Windows 安装版失败：尝试使用免安装版，或以管理员身份运行安装程序。
  • macOS 提示文件损坏：在终端执行 xattr -cr /Applications/lx-music-desktop.app。
  • 杀毒软件报毒：软件代码已开源，安装包由官方自动构建，大概率为误报。详情请参阅常见问题。
  • Android 安装失败：先卸载旧版本再重新安装，并确认系统已允许安装未知来源应用。

安装完成后，建议先浏览一遍软件设置，根据个人喜好调整配置。如有其他问题，请查看常见问题页面。