LX Music 桌面版跨平台同步指南：一个开源音乐客户端如何管好所有设备的歌单
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
换了台新电脑后，上个月整理好的「工作专注」歌单还在吗？LX Music 桌面版是一个基于 Electron 30+ 与 Vue 3 开发的免费开源音乐客户端，它的核心卖点之一就是跨平台同步：通过私有同步服务，把播放列表和不喜欢的歌曲在不同设备间保持一致。桌面歌词、多音乐源切换、开放 API 也都内置。这篇文章带你过一遍功能，再给出最短的上手路径。
功能全景
安装与便携运行
Linux、macOS、Windows 7 及以上三个平台都有对应的安装包，Linux 还提供 deb、rpm、AppImage、pacman 等多种格式。数据默认按系统约定存放，比如 Windows 下是%APPDATA%/lx-music-desktop。如果你在 Windows 程序目录里放一个名为portable的文件夹，软件会自动改用这个目录存数据——装进 U 盘带走，数据一个不落。
多端同步：两台设备怎么连起来
从 v2.2.0 起，LX Music 提供了一个独立的数据同步服务（lx-music-sync-server 项目）。你把它部署到一台能长期访问的机器上，在设置里填入服务地址和授权码，两台设备连上同一个服务后，「我的列表」和不喜欢的歌曲就能互相同步。同步走的是增量模式——只传输有变化的数据，列表再大也不会每次全量重传。这部分逻辑在src/main/modules/sync/下，按客户端和服务端两个方向分开实现。
桌面歌词怎么开
设置里打开桌面歌词后，会弹出一个独立小窗口，跟着播放进度逐行高亮。横向、纵向两种排版随意切换，字体、颜色、透明度都可以调，鼠标闲置一段时间会自动隐藏，不挡工作界面。相关代码在src/renderer-lyric/目录，它本质上是一个单独渲染的窗口，所以歌词可以拖到任何屏幕角上。
多音乐源：怎么切源
内置了酷我、酷狗、咪咕、网易云、QQ、百度音乐几个源的适配模块（src/renderer/utils/musicSdk/下每个源一个目录），在设置里可以切换默认源。某个源拉不到链接时，换个源再试通常就有结果；设置里还留了「自定义源」入口，供你自己接入其他数据源。
播放列表管理
「我的列表」是本地列表，支持增删歌曲、拖拽排序；各平台的在线歌单可以直接浏览并收藏进来；搜索结果页本身也是一个可用的临时列表。配合搜索和历史功能，找歌和建列表基本在几个点击内完成。
主题与开放 API
内置的主题编辑器可以改配色、换背景图，不用改代码就能换个皮肤。从 v2.7.0 起支持开放 API：启用后软件会在本地起一个 HTTP 服务，第三方程序通过接口查询当前播放、控制上下曲和音量；另外从 v1.17.0 起支持 Scheme URL，可以从浏览器等外部场景唤起软件。
上手路径
最短路径是「获取软件 → 配置同步服务 → 多端验证」三步：
- 获取软件：到官方发布页下载对应平台的安装包即可；想从源码构建的话，克隆仓库后按文档装依赖再执行构建：
- 部署同步服务：想多端同步就先在自己能长期访问的机器上部署 lx-music-sync-server。没有官方云服务，服务自托管，这一步只做一次。
- 配置并连接：打开设置里的「同步」页签，填入服务地址，在 A 设备完成连接；再在 B 设备填入同样的信息，确认两边的列表一致就成功了。
同步模块的目录结构大致如下，想深入时可以直接对照代码：
src/main/modules/sync/ ├── client/ # 客户端同步逻辑（认证、数据收发） └── server/ # 服务端处理模块（列表、不喜欢的歌曲）进阶玩法
私有同步服务部署💡 如果你有一台 VPS 或家里常开的机器，把 lx-music-sync-server 部署上去，歌单数据就在你自己的设备与自己的服务之间流转，软件端不会把列表数据放到第三方云上。部署完成拿到授权码后，客户端只需填地址加授权码两步。
开放 API 接入自动化启用开放 API 后，播放状态和播放控制都能通过 HTTP 接口访问，适合接进智能家居或脚本场景，比如「下班到家自动播放」「定时切歌」。接口是本地服务，不暴露到公网，安全性可控。
自定义主题🎨 在主题编辑器里新建主题，调整颜色方案并换上自己的背景图。仓库自带了一批示例背景放在src/common/theme/images/下，比如水墨风格和星空夜景：
从源码参与构建也很直接，克隆仓库切到 dev 分支即可开发：
git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop最后回答两个高频疑问：同步需要服务器吗——需要，服务要自己部署；数据放在哪——存你自己的服务里，软件只维护连接。建议你先翻一遍仓库里的设置项和快捷键说明再开始用；如果发现了 bug，也可以直接向 dev 分支提 PR 参与维护。
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
