LX Music（洛雪音乐助手）：免费开源的多端音乐查找工具 #

LX Music 是什么？ #

LX Music（中文常称“洛雪音乐助手”）是一款免费、开源、无广告的音乐查找工具，官方将其定位为“一个免费&开源的音乐查找工具”。项目基于 React 等现代前端技术构建，同时提供桌面版（lx-music-desktop）与移动版（lx-music-mobile）两条产品线，可在 Linux、macOS、Windows 及 Android 平台上运行。

与常见的商业音乐客户端不同，LX Music 的开发初衷是“对新技术的学习与研究”，因此官方明确承诺软件直至停止维护都将保持纯净，不含广告、弹窗与会员体系。它主要解决用户在多个音乐平台之间反复切换、逐首搜索歌曲的痛点，通过统一的搜索与播放列表管理界面集中管理音乐资源，并支持自定义源脚本扩展、歌单同步、桌面歌词等进阶功能，适合追求轻量、无干扰听歌体验的用户。

LX Music 有哪些亮点特色？ #

• 免费且无广告：官方在首页明确承诺，本项目开发的初衷仅是为了对新技术的学习与研究，因此软件直至停止维护都将会一直保持纯净，全程没有广告、弹窗或会员付费墙。
• 完全开源：项目源码开源发布于 GitHub（桌面版与移动版各有独立仓库），面向全世界用作对技术的学习交流使用，任何人都可以审计代码、自行编译或参与贡献，透明度极高。
• 多端支持：官方支持在 Linux、macOS、Windows 及 Android 平台上运行，桌面端与移动端功能各自独立演进，同一套使用习惯可以跨设备延续。
• 基于 React 构建：官网标注 “Powered by React”，采用现代前端技术栈开发，界面渲染灵活，也便于社区开发者二次开发与自定义主题。
• 自定义源脚本机制：软件支持通过导入自定义源脚本扩展音源，并提供专门的《自定义源脚本编写说明》文档，具备较强的可扩展性。
• 歌单同步与本地播放：内置同步功能，可在多端之间同步「我的列表」；同时支持添加与播放本地歌曲，兼顾在线查找与本地音乐管理。
• 完整的桌面端能力：桌面版提供桌面歌词、Scheme URL 支持、开放 API 服务、启动参数配置、鼠标与键盘快捷操作等进阶功能，可深度融入日常使用流程。
• 活跃的文档与社区支持：官网文档中心按“桌面版文档 / 移动版文档”分类，覆盖常见问题、安装失败排查、数据存储路径、许可协议等内容，并提供 GitHub Issues 作为问题反馈渠道。

免费下载 LX Music #

以下为官方提供的各平台安装包（v2.12.6），点击链接即可下载。请根据自己的操作系统与处理器架构选择对应版本。

提示：Linux 与 Android 版本的安装包请前往官网「软件下载」页面或 GitHub Releases 获取；移动端移动版与桌面版版本号体系不同，请勿混用。

LX Music 如何使用？ #

LX Music 的上手流程非常简单，桌面版与移动版的操作逻辑基本一致：

1. 启动软件：安装完成后打开 LX Music，首次启动会进入主界面，左侧（桌面版）或底部（移动版）为导航栏，包含搜索、我的列表、设置等入口。
2. 搜索歌曲：在搜索框中输入歌名、歌手或专辑名，软件会调用当前可用的音源进行查找，搜索结果以列表形式展示，点击即可播放。
3. 管理播放列表：可将喜欢的歌曲加入「我的列表」，支持新建歌单、列表多选、批量调整歌曲顺序、播放整个歌单或排行榜等操作。
4. 导入自定义源：进入「设置 → 自定义源」，导入你自行编写或从社区获取的自定义源脚本，导入成功后方可正常试听与下载歌曲（详见下方常见问题）。
5. 进阶功能（桌面版）：可在设置中开启桌面歌词、配置同步功能、设置下载路径、使用 Scheme URL 或开放 API 服务，也可通过鼠标与键盘快捷键快速操作。

提示：若桌面版与移动版希望共用歌单，可使用内置的同步功能，在两端填写相同的同步配置即可。

LX Music 的常见问题？ #

为什么所有歌曲都提示“换源失败，请尝试手动…”？

由于收到腾讯投诉，要求停止内置其平台的在线播放及下载服务，从 2023-10-18 起 LX Music 本身不再提供该服务——桌面版 v2.6.0 已移除所有内置自定义源，移动版 v1.2.0 同样移除了内置源，且旧版本内置的源也已失效。你需要自行编写或寻找他人分享的自定义源脚本并导入，才可正常使用，官方提示可以到 GitHub Issues 中寻找。

macOS 提示“lx-music-desktop 已损坏”“无法打开”“无法验证开发者”怎么办？

这是因为软件没有进行 Apple 签名，被系统安全机制阻止运行。在终端中执行以下命令并回车，然后输入电脑密码（输入时屏幕不显示字符）即可：

sudo xattr -rd com.apple.quarantine /Applications/lx-music-desktop.app

Windows 上所有歌曲都提示“音频加载错误，5 秒后切换下一首”？

可按顺序尝试两种方法：一是关闭「Internet 选项」的代理设置（按 Win + R 输入 inetcpl.cpl，依次点击「连接 → 局域网设置」，取消「代理服务器」与「自动配置」下的勾选，确定后重启软件）；二是卸载软件（注意备份歌单），安装时选择「仅为我安装」，重新安装到系统分区并使用默认路径。

歌曲下载失败，提示 ENOENT: no such file or directory, mkdir？

该问题通常是由于设置的下载目录没有读写权限导致的，更换一个新的歌曲下载路径即可解决。

Windows 安装版覆盖安装失败，或安装后无法启动？

覆盖安装失败一般是因为最初以「管理员身份」安装、之后未以管理员身份运行，导致权限冲突。官方建议安装时选择「仅为我安装」，并安装到当前用户目录或不需要管理员权限的目录。若安装后目录中只有卸载程序，通常是使用了错误的安装包（例如在 x64 系统上用了 Windows Arm64 版安装包），卸载后换用正确安装包即可。

移动端支持歌曲下载功能吗？

不支持。根据官方移动版 FAQ 说明，移动端暂不支持歌曲下载功能。

杀毒软件提示有病毒或恶意行为？

官网 FAQ 中专门收录了该条目（桌面版与移动版均有），通常属于误报，可在官网对应 FAQ 页面查看官方说明，并将软件加入杀毒软件白名单。

LX Music 如何安装？ #

Windows 平台

1. 根据你的系统架构下载对应的安装包：普通 64 位系统选择 lx-music-desktop-v2.12.6-x64-Setup.exe，Arm64 设备选择 lx-music-desktop-v2.12.6-arm64-Setup.exe，Windows 7 用户选择 lx-music-desktop-v2.12.6-win7_x64-Setup.exe。
2. 双击运行安装程序，在安装类型中选择「仅为我安装」，并安装到当前用户目录或不需要管理员权限的目录（官方明确不建议选择「为使用这台电脑的任何人安装」）。
3. 按提示完成安装后启动软件即可。覆盖安装时不要更改安装目录，如需更换目录请先卸载再重新安装。
4. 若提示缺少 xxx.dll，请确认你使用的是免安装版（需完整解压所有文件）还是安装版（可能需要修复系统组件，可尝试 sfc /scannow）。

macOS 平台

1. 下载 .dmg 文件：Apple Silicon（M 系列芯片）选择 arm64 版本，Intel 机型选择 x64 版本。
2. 打开 dmg 并将 lx-music-desktop 拖入「应用程序」文件夹。
3. 首次启动若提示「已损坏」或「无法验证开发者」，在终端执行上方 FAQ 中的 sudo xattr -rd com.apple.quarantine 命令后再打开。

Linux 平台

LX Music 支持在 Linux 上运行，可从官网「软件下载」页或 GitHub Releases 获取对应发行格式的安装包（如 AppImage 等），按官方说明解压或赋予可执行权限后运行。

Android 平台

移动版通过官网「软件下载」页或 GitHub Releases 获取 APK 安装包，下载后允许「安装未知来源应用」并完成安装即可。移动版与桌面版为两套独立的软件，请注意版本号区分。

LX Music 如何卸载？ #

Windows 平台

1. 打开「控制面板 → 程序和功能 / 卸载程序」，找到 LX Music（lx-music-desktop）并选择卸载。
2. 若曾以管理员身份安装导致卸载异常，可尝试使用第三方卸载工具清理残留，或手动清理安装路径下的残留文件与注册表项（官方 FAQ 建议使用清理工具清理注册表）。
3. 卸载前请注意备份歌单——你的播放列表数据保存在软件数据目录中，卸载操作可能导致本地数据一并被移除。

macOS 平台

1. 退出 LX Music，打开「访达 → 应用程序」，将 lx-music-desktop.app 拖入废纸篓并清空。
2. 如需彻底清理，可手动检查用户资源库中的配置与缓存目录并删除（具体路径以软件「数据存储路径」说明为准，官网文档中有单独的《数据存储路径》页面可供参考）。

Linux 平台

若通过 AppImage 方式使用，直接删除对应的 AppImage 文件即可；若通过发行版包管理器安装，使用对应的包管理器卸载命令（如 apt remove、pacman -R 等）卸载。

Android 平台

长按应用图标选择「卸载」，或在「设置 → 应用管理」中找到 LX Music 执行卸载。卸载前同样建议先确认歌单是否需要保留。

通用提醒：无论哪个平台，卸载前都建议先在软件内导出或同步歌单，避免本地数据丢失。