如何免费听遍全网歌曲：LX Music 五音源聚合搜索、批量下载与定制播放完整教程
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
LX Music 是基于 Electron 与 Vue 3 的开源音乐播放器（Apache 2.0 协议），把酷我、酷狗、QQ 音乐、网易云、咪咕五个音源的搜索与试听聚合到一个窗口，支持 flac24bit 试听和批量下载。下面按真实使用流程讲一遍。
📦 Windows、macOS、Linux 分别该装哪个安装包
结论：按系统选包，Windows 用户优先装安装版，因为只有它支持自动更新。
各平台可选的包类型：
- Windows：安装版（Setup）与绿色版（green）。只有安装版会在启动时检查并提示更新；绿色版需手动换包。
- macOS：
.dmg安装包。 - Linux：
.deb、.rpm、.AppImage、.pacman四种格式。
绿色版还有一个便携玩法：v1.17.0 起，只要程序目录里存在portable文件夹，配置和列表就会直接写进该文件夹，整个目录拷到 U 盘即可带走（详见 README.md 的数据存储说明）。
首次启动后建议先翻一遍设置，按自己的习惯调整播放音质、下载位置等项，后面基本不用再动。
🔍 LX Music 聚合搜索与试听：输歌名五音源同时返回
结论：搜索框不用选平台，回车后五个音源的结果合并展示，每条结果旁标注可用音质。
- 可选音质有 128k、320k、flac、flac24bit 四档。默认播放音质是 128k，日常够用且省流量，网络好就去设置里调高。
- 点任意一条结果即可播放，歌曲会自动进入本地播放列表，之后在"我的列表"里就能找到，无需重复搜索。
- 偶尔单曲加载失败不用管："出错自动跳过"默认开启，会直接切下一首。
- 如果整页结果都刷不出来，优先到"设置 → 音乐来源"换一个接口源；仍不行再检查本机代理设置。
⬇️ LX Music 批量下载教程：开启开关、核对默认值、管理本地曲库
结论：下载功能默认是关着的，第一步先去"设置 → 下载"里把它启用。
启用后，用鼠标多选歌曲再右键"下载"就行：Ctrl点选不连续的曲目，Shift连选一片，Ctrl+A全选。
第一次下载前，建议逐项核对下面的默认行为（默认值定义在 src/common/defaultSetting.ts）：
| 配置项 | 默认行为 | 说明 |
|---|---|---|
| 保存位置 | 桌面 | 可改成任意有写权限的目录 |
| 文件名格式 | 歌名 - 歌手 | 支持自定义 |
| 并发任务数 | 3 | 批量下载时同时跑的任务数 |
| 同名文件 | 跳过 | 已存在的文件不会被覆盖 |
| 封面处理 | 写入音频文件 | 内嵌开关默认开启 |
| 歌词处理 | lxlrc 格式默认嵌入 | 普通 lrc 需手动勾选 |
| 目录结构 | 平铺存放 | 可选"按列表名分目录"，适合按歌单整理 |
下载完成的歌曲集中在"下载"页面管理：可以直接播放、重试失败的任务，也可以右键把歌曲加回列表。
🪟 LX Music 桌面歌词、主题切换与快捷键怎么自定义
结论：三样东西都在设置里改——主题一键切换、桌面歌词独立成窗、快捷键分应用内和全局两套。
主题。内置主题在"设置 → 主题"里一键换，其中水墨风的"近墨者黑"和暗色的"黑灯瞎火"都很耐看：
主题背景图统一放在 src/common/theme/images/ 目录下，设置里也支持自己创建主题。
桌面歌词。它是一个独立小窗，默认尺寸 450×300，横排/竖排、字号、已播与未播文字颜色、透明度都能调。窗口可以拖到屏幕任意角落，支持锁定位置和始终置顶；默认还会在全屏或暂停时自动隐藏，不挡屏幕。
快捷键。全局快捷键默认关闭，在"设置 → 快捷键"里打开后，窗口失焦也能控制播放：
| 按键 | 功能 | 生效范围 |
|---|---|---|
| F1 | 聚焦搜索框 | 应用内 |
| Ctrl+F5 | 播放 / 暂停 | 应用内 |
| Ctrl+← / Ctrl+→ | 上一曲 / 下一曲 | 应用内 |
| Ctrl+Alt+F5 | 播放 / 暂停 | 全局 |
| Ctrl+Alt+↑ / ↓ | 音量加 / 减 | 全局 |
| Ctrl+Alt+0 | 显示 / 隐藏桌面歌词 | 全局 |
🚀 LX Music 开放 API、数据同步与自定义音源怎么用
结论：进阶能力都默认关闭，按需开启；开放 API 只监听本机，数据同步走局域网。
开放 API。在设置里开启后，本地默认监听127.0.0.1:23330，对外提供/play、/pause、/skip-next、/status、/lyric、/volume、/seek、/collect等 HTTP 端点，实现代码在 src/main/modules/openApi/ 目录，可以直接读。其中/subscribe-player-status以事件流持续推送播放状态，适合做歌词桌宠、状态面板这类小工具。验证服务是否起来了，一条命令就够：
curl http://127.0.0.1:23330/status数据同步。在"设置 → 数据同步"里启动本地服务，默认端口23332；手机端填入 PC 显示的地址后，歌单、列表、设置就能在同一局域网内互相同步。注意传输是明文的，只在可信网络下使用，并且首次同步前建议先备份一次列表。
自定义音源。在用户数据目录放一个 JavaScript 脚本，让它监听musicUrl事件并返回歌曲直链，就相当于给 LX Music 加了一个新音源。脚本内可用request发没有跨域限制的 HTTP 请求，还自带 AES、MD5、RSA 等加解密工具。
🔧 LX Music 常见问题速查：试听失败、界面空白、下载报错
结论：日常故障大多集中在这三类，按"换源 → 换网 → 改 DNS"的顺序排查基本都能解决。
所有歌曲都提示请求异常：当前接口源不可用，或本机 DNS 到不了接口服务器。先去"设置 → 音乐来源"换源，再切手机热点快速验证网络；还不行就把 DNS 改成223.6.6.6或8.8.8.8，然后重启软件。
Windows 10/11 界面显示不全或整屏空白：GPU 沙箱与显卡驱动冲突。给快捷方式加启动参数--disable-gpu-sandbox；无效再依次换成--no-sandbox、-dha、--disable-gpu尝试。
下载报ENOENT: no such file or directory：所选下载目录没有读写权限，换一个有权限的目录即可，比如在用户主目录下新建一个文件夹。
更多细节可对照仓库里的 FAQ.md。
📁 LX Music 数据目录在哪里，最后说两句
你的配置、列表、下载记录都存在各平台的固定位置：
- Windows：
%APPDATA%/lx-music-desktop - Linux：
~/.config/lx-music-desktop - macOS：
~/Library/Application Support/lx-music-desktop
（Windows 下启用便携模式时，数据会写进程序目录的portable文件夹。）
到这里，LX Music 的主干流程就走通了：装对包 → 搜到歌 → 下下来 → 调成自己喜欢的样子。日常卡点基本就是接口源问题，按"换源 → 换网 → 改 DNS"排一遍；想再进阶，就接上开放 API 和自定义音源，文中都给了对应的入口和代码位置。
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
