LX Music 快速上手：如何用一个搜索框搜遍5大音源并搭建本地曲库

【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop

LX Music 是一款基于 Electron 30 与 Vue 3 的开源音乐播放器，把酷我、酷狗、QQ音乐、网易云、咪咕 5 个音源的在线数据汇进同一个搜索框，试听最高支持 flac24bit 音质，还能批量下载并写入封面与歌词。下面按实际使用顺序讲清楚：安装包怎么选、歌怎么存进本地、出了问题怎么查、怎么把主题和歌词窗调到自己顺手，最后再说数据同步与开放 API 这类进阶玩法。

怎么挑 LX Music 安装包：先回答3个问题

问题一：你的系统是什么？

问题二：系统是 32 位还是 64 位？文件名带x64对应 64 位、x86对应 32 位、arm对应 ARM 架构；同时标注两者的集合版会在安装时自动匹配位数。

问题三：装在哪？Windows 版从 v1.17.0 起支持便携模式：程序所在文件夹里多一个portable文件夹，配置和列表就全部写进该文件夹，整个目录拷进 U 盘即可带走。其他平台的数据默认存放在系统固定目录，文末有速查表。

装好后启动，界面就四块：左侧导航（搜索、排行榜、我的列表、下载、设置）、顶部搜索框、中部歌曲列表、底部播放控制栏。按F1直接跳到搜索框，后面所有操作都从这里开始。

从搜歌到入曲库：如何打开 LX Music 批量下载

搜。输入歌名回车，五个音源的结果会合并成一张列表，不用先挑平台。每条结果旁边标着当前可下载的音质档位：128k、320k、flac、flac24bit。

听。点任意一条直接播放。注意一个机制：你从搜索结果、歌单或排行榜里点歌时，这首歌会自动先进入"我的列表"里的试听列表再开始播，所以听过什么之后都能去"我的列表"翻到，不用重新搜。

存。批量下载默认是关着的，第一次用之前先去"设置 → 下载"把开关打开。然后返回列表多选：Shift点两端做连续选择，Ctrl点单项做跳跃选择，Ctrl+A全选，选中后右键 → 下载。默认值对照下面这份清单确认即可（全部在"设置 → 下载"里可改，代码出处见 src/common/defaultSetting.ts）：

• 文件命名：歌名 - 歌手
• 下载目录：桌面
• 并行任务数：3，网络好可往上加
• 同名文件：跳过已存在的，重跑任务不会覆盖旧文件
• 封面写入音频：默认开启，想省空间再关
• 歌词：lxlrc 格式默认嵌入；普通 lrc、翻译、罗马音需分别手动勾选
• 按列表名分目录：默认关闭，想按歌单整理曲库时再开

任务结束后到"下载"页面统一处理：能播放、能补跑失败任务，也能右键把已下歌曲加回列表。

卡住了怎么办：4个常见症状与自查方法

排障时先分清"接口问题"和"本机问题"，下面四组症状基本覆盖了绝大多数情况，详细背景可看 FAQ.md。

症状：整页搜索刷不出来，歌曲一律提示请求异常判断：接口源不可用，或本机 DNS、网络到不了接口服务器。 处理：先"设置 → 音乐来源"换一个接口源；再连手机热点验证是否网络自身的问题；还不行就把 DNS 改成223.6.6.6或8.8.8.8，重启软件再试。

症状：Windows 上所有歌曲提示"音频加载错误，5秒后切换下一首"判断：多半是系统代理设置干扰了音频流。 处理：按Win+R输入inetcpl.cpl，在 Internet 选项的连接 → 局域网设置里，把代理服务器和自动配置的勾选去掉，确定后重启软件。

症状：Windows 10/11 界面整屏空白或显示不全判断：GPU 沙箱与显卡驱动冲突，属渲染层问题，与数据无关。 处理：给快捷方式加启动参数--disable-gpu-sandbox；无效就依次试--no-sandbox、-dha、--disable-gpu，哪个恢复显示就用哪个。这类参数会削弱安全特性，问题解决后建议去掉。

症状：下载报错ENOENT: no such file or directory, mkdir判断：所选下载目录没有读写权限，连建文件夹都失败。 处理：把下载目录换成有权限的路径，例如用户主目录下自己新建的文件夹。

主题与桌面歌词：如何把 LX Music 调到自己顺手

音质档位。四个档位 128k / 320k / flac / flac24bit 在"设置 → 播放"里选，默认 128k，日常够用且省流量，网络条件好再调高。同页有个值得留意的开关"出错自动跳过"，默认开启——某首歌加载失败时直接切下一首，不用你手动干预。

主题。内置十五套主题一键切换，名字挺有趣：绿意盎然、蓝田生玉、月里嫦娥、近墨者黑、新年快乐（春节时段会自动换上它）等。想自己搞一套也行：设置里自建主题，拖一张背景图、配一个主色即可。内置主题的背景图都在 src/common/theme/images/ 目录，效果如下：

桌面歌词。在"设置 → 桌面歌词"里开启后，它会以独立于主窗口的形式出现，默认尺寸 450×300。可参数化调整：横排或竖排、字号、已播/未播歌词颜色、窗口透明度。窗口本身支持锁定位置和始终置顶，拖到屏幕任意角落；主窗口进全屏或歌曲暂停时它默认自动隐藏，不挡屏幕。

快捷键分应用内和全局两套，都在"设置 → 快捷键"里管理：

• 应用内（默认启用）：F1聚焦搜索框；Ctrl+F5播放/暂停；Ctrl+←/Ctrl+→上一曲/下一曲；另有F11进入或退出全屏
• 全局（默认关闭，打开后窗口失焦也能控）：Ctrl+Alt+F5播放/暂停；Ctrl+Alt+←/→切歌；Ctrl+Alt+↑/↓音量加减；Ctrl+Alt+0桌面歌词显隐

macOS 上Ctrl一律对应Cmd。建议至少把全局的播放/暂停和歌词显隐两项打开，切窗口时还能顺手控制播放。

进阶玩法：如何开启 LX Music 数据同步与开放 API

两项功能都在设置里、默认全部关闭，用到再开。

数据同步。在"设置 → 数据同步"里启动本地服务，默认监听端口23332，手机端在同步设置里填入 PC 显示的局域网地址即可，歌单、列表、设置会在多台设备间互相同步。两点提醒：传输是明文，只放在可信局域网里用；首次同步前先把列表备份一次，同步出问题时能回滚。连通性检查很简单：手机浏览器打开http://PC地址:23332/hello，能显示欢迎语就说明两端网络已互通。服务端实现见 src/main/modules/sync/。

开放 API。在"设置 → 开放 API"里开启后，软件会起一个 HTTP 服务，默认只监听127.0.0.1:23330（即只接受本机调用，需要局域网访问再打开 bindLan 开关）。对外暴露/status、/play、/pause、/skip-next、/skip-prev、/seek、/volume、/mute、/collect、/uncollect、/lyric、/lyric-all等端点；/subscribe-player-status以 SSE 事件流持续推送播放状态，默认推送歌名、歌手、专辑、当前歌词行、时长、进度、倍速等字段，拿它做歌词桌宠、状态面板最方便。实现代码见 src/main/modules/openApi/。服务起来后本机一条命令验证：

curl http://127.0.0.1:23330/status

返回当前播放状态的 JSON 就说明端点可用。

自定义音源。给 LX Music 加新音源的方式，是准备一个 JavaScript 脚本在设置里导入：脚本声明支持的源与musicUrl动作，运行时监听应用发来的请求，被点名时返回该歌曲的 http/https 直链。脚本里可以直接用lx.request发 HTTP 请求（不受跨域限制，且跟随软件内的代理设置），加解密方面自带 AES、MD5、RSA 等工具函数，应付大多数音源接口的签名逻辑够了。运行时实现在 src/main/modules/userApi/。适合给某个平台配专属音源，或在默认音源不稳定时留一条备用链路。

LX Music 数据存在哪里

配置、列表、下载缓存都落在平台固定的数据目录里：

• Windows：%APPDATA%/lx-music-desktop
• Linux：~/.config/lx-music-desktop
• macOS：~/Library/Application Support/lx-music-desktop
• 例外：Windows 版（v1.17.0 及以上）程序目录下有portable文件夹时，数据直接写进该文件夹

给新手的三句落地建议：第一次用选 Windows 安装版，更新提示是现成的；出问题基本都卡在接口源上，按"换源 → 换网 → 改 DNS"的顺序排查，别跳步；想深挖就先把开放 API 开起来，自定义音源和桌面歌词都建立在这套本地服务之上。版本变化可查 CHANGELOG.md。

【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop