LX Music 桌面版完全指南：免费开源多源聚合音乐播放器如何从零上手
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
如果你也厌倦了「一首歌在 A 平台、另一首在 B 平台」的折腾，LX Music 桌面版值得试试——这是一款免费开源的音乐播放器，把酷我、酷狗、QQ、咪咕、网易云等多个音乐源聚合到一个界面里，搜一首、点播放，不用为任何一首歌纠结会员。
项目画像：它到底是什么
一句话概括：LX Music 桌面版是一个基于 Electron + Vue 3 的跨平台音乐播放软件，由开发者以个人项目形式维护，界面清爽、功能不啰嗦。
| 项目信息 | 说明 |
|---|---|
| 定位 | 免费的在线音乐查找 + 播放器 |
| 技术栈 | Electron 30+ 与 Vue 3 |
| 开源协议 | Apache License 2.0（可自由使用、修改、分发） |
| 支持平台 | Windows 7 及以上、macOS、Linux |
| 内置音乐源 | 酷我（kw）、酷狗（kg）、QQ 音乐（tx）、网易云（wy）、咪咕（mg） |
| 数据归属 | 本地存储，支持自建私有同步服务 |
音质方面，它支持 128k、320k、flac 等规格，具体以各平台实际可提供的为准。
左侧是导航区，中间是列表区，底部是完整的播放控制条，整体布局对习惯传统播放器的人几乎零学习成本。
上手指南：三步装好并听到第一首歌
第一步：按系统选对安装包
| 平台 | 推荐格式 | 备注 |
|---|---|---|
| Windows | .exe安装版 或 绿色版（green） | 安装版支持自动更新；绿色版可放 U 盘使用 |
| macOS | .dmg | 首次启动若提示「已损坏」，参考下文问题速解 |
| Linux | .deb/.rpm/.AppImage | 按发行版选择即可 |
更省事的方式是从源码启动（需要 Node.js ≥ 22、npm ≥ 8.5.2）：
git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop cd lx-music-desktop npm install npm run dev第二步：首次配置四件事
- 音乐来源：在设置中确认启用的音乐源与接口，后续遇到某源失效可在这里切换；
- 音质偏好：网络一般的场景选 128k/320k 更流畅，Wi-Fi 环境下可试无损；
- 下载目录：指定一个有读写权限的本地文件夹，避免下载报错；
- 主题：随便挑一个顺眼的，之后想换随时可换。
官方也提醒过：默认设置并非以「新手友好」为目标，花两分钟过一遍设置面板，后面会省不少事。
第三步：完成你的第一次搜索
- 按
F1直接聚焦顶部搜索框，输入歌名或歌手名； - 回车后，软件会汇总各音乐源的结果，同一首歌通常带多个来源和音质选项；
- 单击播放试听；喜欢的话按
Ctrl再点选多首歌，右键「添加到我的列表」，它们就会进入你本地的歌单。
到这里，一个可以长期用的音乐库就搭起来了。
功能核心：四个值得深挖的能力
多源搜索：一搜多平台的结果
这是它和单一平台客户端最大的差异。搜索一次，五个源同时返回结果，软件会合并展示，你可以按平台挑选音质更好的版本。如果某个源的接口临时抽风，在「设置-音乐来源」里换一个接口或源就能绕过，不必整首歌放弃。
桌面歌词：独立窗口的实时歌词
开启后，歌词会跑进一个独立的小窗口，和主程序互不干扰：
- 支持垂直滚动与横向两种显示模式（源码见 src/renderer-lyric/）；
- 可置顶、可锁定位置、鼠标悬停/暂停时智能隐藏；
- 字体、颜色、透明度都能在「设置-桌面歌词」里调（对应 SettingDesktopLyric.vue）；
- 配合全局快捷键，不切窗口也能控制歌词窗口。
主题定制：15 套内置主题 + 自定义编辑器
内置主题在 src/common/theme/index.json 中定义，从「绿意盎然」「蓝田生玉」这类素雅配色，到带背景图的「近墨者黑」（中国风水墨）、「木叶之村」（动漫风）、「月里嫦娥」都有，节日季还能换上「新年快乐」：
如果觉得内置款不够，设置里自带主题编辑器（ThemeEditModal），颜色、背景图、亮暗模式都能自己捏。
数据同步与开放 API：数据攥在自己手里
- 私有同步服务（v2.2.0 起）：项目单独发布了同步服务端，部署到自家服务器后，多台设备的歌单、设置可实时同步，数据全程不出自己的服务器；
- 局域网同步：手机与 PC 同网段时，还能走内置同步功能实时互通列表；
- 开放 API（v2.7.0 起）：本地起一个 HTTP 服务，把播放、切歌等操作暴露给第三方脚本调用，方便接自己的自动化流程；
- 另支持
lxmusic://形式的 Scheme URL，可从浏览器等外部场景唤起软件。
实用篇：快捷键、多选与列表管理
常用快捷键（软件内生效）
| 快捷键 | 作用 |
|---|---|
Ctrl+F5 | 播放 / 暂停 |
Ctrl+←/Ctrl+→ | 上一首 / 下一首 |
F1 | 聚焦搜索框 |
全局快捷键（需先在「设置-快捷键」里开启）：Ctrl+Alt+F5播放/暂停、Ctrl+Alt+↑/↓调音量、Ctrl+Alt+0显示/隐藏桌面歌词、Ctrl+Alt+-锁定歌词位置。macOS 上Ctrl对应Command键。
多选与批量操作
Shift+点击选连续区间，Ctrl+点击选不连续歌曲，Ctrl+A全选；- 选中后右键即可批量加入歌单、下载或加入「稍后播放」；
- 在「我的列表」里按住
Ctrl拖动，可以调整歌单顺序； - 往多个歌单加同一批歌时，在添加弹窗里按住
Ctrl点歌单名，窗口不会自动关闭。
列表机制：先搞懂「试听列表」和「稍后播放」
- 直接点搜索/歌单/排行榜里的歌播放时，歌曲会自动先进入「我的列表」里的试听列表，再开始播；
- 「稍后播放」是优先级最高的临时队列，按「下一首」顺序消耗，手动切歌时会清空；
- 想连续听一整首列表的歌，正确姿势是：全选 → 加入某个自建列表 → 播放该列表。
这套机制的详细解释可以直接看仓库自带的 常见问题。
不同角色的使用思路
- 学生党：优先低音质省流量 + 批量下载，断网时照样听；
- 多设备用户：部署私有同步服务，PC 与手机保持同一套列表结构；
- 技术爱好者：用开放 API 写个小脚本（比如「下班自动播通勤歌单」），或研究 src/renderer/utils/musicSdk/ 里的各平台接口实现，学一学前端对接多源 API 的思路。
问题速解：常见故障排查表
| 现象 | 常见原因 | 处理方式 |
|---|---|---|
| 所有歌曲都「请求异常」 | 网络或 DNS 访问不到接口 | 换移动网络试试；把 DNS 改为自动或手动指定公共 DNS 后重启软件 |
| Windows 全部歌曲「音频加载错误」 | 系统代理设置干扰 | 打开 Internet 选项 → 连接 → 局域网设置，取消代理勾选 |
下载报ENOENT ... mkdir | 下载目录没有读写权限 | 换一个有权限的下载目录 |
| 界面显示不完整/透明异常 | 硬件加速问题 | 以-dha参数启动禁用硬件加速 |
| macOS 提示「已损坏」 | 软件未签名被系统拦截 | 终端执行去除隔离属性的命令后重试 |
| 搜索/歌单全部加载不出来 | 应用内代理配置错误 | 检查「设置-网络」中的代理配置，乱配的代理会直接断网 |
更完整的排查链路（含各系统细节）在 FAQ.md 里都有，遇到怪问题先翻它。
数据备份与恢复
所有歌单、设置都存放在本地一个文件夹里，备份就是复制这个文件夹：
| 系统 | 数据目录 |
|---|---|
| Windows | %APPDATA%/lx-music-desktop |
| macOS | ~/Library/Application Support/lx-music-desktop |
| Linux | ~/.config/lx-music-desktop |
Windows 下若程序目录存在portable文件夹，数据会自动落到那里（便携模式）。建议每月备份一次，重点保住「我的列表」；恢复时只需关闭软件、把备份文件夹放回原处再启动即可。
生态与展望
- 参与开发：项目欢迎 PR——新功能建议先提 Issue 讨论，修 bug 请附重现方式，开发在
dev分支进行； - 跟踪更新：每次版本的改动都记录在 CHANGELOG.md，更新频率相当稳定；
- 周边动态：团队还维护着移动版与同步服务端，并公布了新项目计划，未来方向可在仓库 Issue 区跟进。
收尾
LX Music 桌面版用「免费开源 + 多源聚合 + 数据自主」的组合，把找歌这件事的摩擦降到了最低。现在就下载安装一个版本，用F1搜一首你最近单曲循环的歌，让它跑起来试试——你的歌单，从这一首开始搭建。
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
