macOS 与 Linux 安装指南——dmg、AppImage、deb 三种形态

macOS 安装

步骤 1：下载正确的 dmg

根据你的 Mac 芯片选择：

• Intel 芯片（2020 年前的 Mac）：下载文件名带 x64 的 .dmg。
• Apple Silicon（M1 / M2 / M3 / M4）：下载文件名带 arm64 的 .dmg。

可以点击左上角苹果图标 → 「关于本机」确认芯片类型。

步骤 2：打开安装包

双击下载的 .dmg 文件。Finder 会弹出一个安装窗口，左侧是洛雪音乐图标，右侧是「Applications」文件夹图标。

步骤 3：拖入应用程序文件夹

将洛雪音乐图标拖拽到「Applications」文件夹图标上。复制完成后在 Finder 的左侧栏可以看到洛雪音乐已经出现在应用程序列表中。

步骤 4：首次启动

进入「启动台」，找到洛雪音乐图标并点击。macOS 可能弹出「无法打开，因为无法验证开发者」的提示，此时：

1. 打开「系统设置」→「隐私与安全性」。
2. 滚动到底部，会看到一条关于洛雪音乐的提示。
3. 点击「仍要打开」，在弹出的对话框中再次确认「打开」。

之后直接双击 Applications 文件夹中的洛雪音乐图标即可正常启动。

macOS 常见问题

提示文件已损坏

在终端中执行：

xattr -cr /Applications/lx-music-desktop.app

然后重新打开应用即可。这条命令会清除 macOS 的扩展属性标记，通常能解决 Gatekeeper 的验证拦截。

拖拽时提示没有权限

确认应用程序文件夹有写入权限。如果是系统级的 Applications 文件夹，可能需要管理员密码。

Linux 安装

Linux 提供四种包格式，选择适合你发行版的格式：

AppImage（最通用）

AppImage 是一个自包含的可执行文件，不依赖发行版包管理器，不需要 root 权限，适合任何 Linux 发行版。

# 下载后赋予执行权限
chmod +x lx-music-desktop*.AppImage

# 直接运行
./lx-music-desktop*.AppImage

AppImage 格式不会自动更新，需要手动下载新版替换。

deb（Debian / Ubuntu 系）

sudo dpkg -i lx-music-desktop*.deb

如果安装过程提示缺少依赖，执行 sudo apt -f install 自动补全依赖。

rpm（Fedora / CentOS / openSUSE）

sudo rpm -i lx-music-desktop*.rpm

pacman（Arch Linux）

sudo pacman -U lx-music-desktop*.pacman

安装完成后，洛雪音乐会出现在系统应用菜单中。

Linux 常见问题

启动后界面空白或显示异常

可能是桌面环境对 Electron 应用的 Wayland 支持问题。尝试在启动参数中加入 --enable-features=WaylandWindowDecorations 或切换到 X11 会话。

桌面歌词窗口位置固定

某些 Linux 桌面环境的窗口管理器可能对桌面歌词窗口行为有限制。可以尝试切换窗口管理器或关闭桌面歌词的置顶选项。

杀毒软件提示

Linux 上杀毒软件误报较少，但如果有类似 ClamAV 的工具误报，可以将洛雪音乐的安装目录加入白名单。

安装完的第一件事

macOS 和 Linux 用户同样需要注意：安装完成后洛雪音乐默认没有任何内置音源。第一次打开软件搜到空结果是正常的。请先阅读 音源配置板块 解决。