LXMusic 洛雪音乐完整使用指南

这是什么

洛雪音乐 LXMusic 是一款基于 Electron 和 React Native 开发的开源跨平台音乐播放器。它的核心特点——没有内置音乐源，完全依靠用户导入的自定义脚本获取资源——让它成为主流音乐 APP 之外最受折腾党欢迎的选择。

本指南面向第一次接触洛雪音乐的用户。以下从安装讲起，帮助解决最常见的「装完搜不到歌」问题，逐步掌握搜索播放、歌单管理、下载、桌面歌词、跨端同步等功能，最后介绍开放 API 和自定义音源脚本等进阶玩法。

产品档案速览

结构导览

下面是本指南的主要板块。建议从上往下读，第一次使用洛雪音乐的用户先看「认识洛雪音乐」了解产品背景，然后直接跳到「音源配置」解决最痛的问题。

认识洛雪音乐

了解洛雪音乐的定位、技术架构，以及它和网易云音乐、QQ 音乐等主流 APP 的核心差异。特别要看「为什么没有内置音源」这一页——这是新用户最容易误解的地方。

安装与启动

覆盖 Windows、macOS、Linux、Android 四个平台的安装方式，包括 Setup 安装包、绿色便携版、AppImage、dmg、APK 等不同分发形态的使用方法。

音源配置

全站最核心的板块。为什么装完搜不到歌、什么是自定义源、怎么导入、怎么初始化、怎么切换和回退——如果只看一个板块，就看这个。

搜索与播放

搜歌、切歌、播放模式、队列管理、桌面歌词的开启与设置，涵盖日常播放的全部基础操作。

歌单与收藏

收藏在线歌单、多选批量操作、稍后播放队列、列表排序与更新、导入外部歌单。

下载与音质

桌面版下载功能的音质层级、下载目录权限设置、多任务进度管理、以及封面和歌词的自动保存。启用开关在音源配置板块。

本地音乐管理

把硬盘里的 MP3 导入洛雪音乐，与在线歌曲统一管理；乱码修复；本地文件损坏时自动搜在线版本的降级机制。

跨端同步

实验性功能，支持桌面版作为同步服务器、移动版作为客户端连接、以及独立部署同步服务三种模式。

桌面版专属功能

快捷键全集、开放 HTTP API、SSE 实时订阅、Scheme URL 深度链接、启动参数、数据存储路径、自定义源脚本编写、主题与界面调整。

移动版专属功能

移动版与桌面版的差异汇总、长按多选、桌面歌词需悬浮窗权限、息屏自动暂停修复、后台划卡仍播放的原因。

常见问题排查

每个问题一页，覆盖全部换源失败、请求异常、音频输出设备为空、下载目录权限、桌面歌词不显示、界面不渲染、杀毒误报、同步端口被拦、无法导入歌单、更新日志查看。