多平台音乐搜索、跨端同步与桌面歌词一次搞定：LX Music 桌面版实用指南
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
你有没有这种经历：在手机上听惯的歌，回到电脑前想接着听，却发现收藏列表还在另一个设备上；同一首歌，几个平台各有一个版本，来回切换 App 十分折腾。LX Music 桌面版就是一个基于 Electron 和 Vue 3 开发的跨平台音乐软件，它把酷我、酷狗、咪咕、网易云、QQ 音乐、虾米等多个音乐源的歌曲聚合到同一个界面里，让你搜索、播放、下载、整理一气呵成，还能把播放列表同步到你的手机上。
项目速览
LX Music 桌面版（当前版本 2.12.2，Apache-2.0 协议开源）的定位可以概括为一句话：一个免费的多平台音乐查找与播放助手。它的几个核心卖点：
- 跨平台运行：支持 Linux、macOS 和 Windows 7 及以上系统，一套界面在所有平台上体验一致
- 现代化技术栈：Electron 30+ 搭配 Vue 3，数据层使用 better-sqlite3 本地数据库，播放、歌词、下载等功能都有独立模块支撑
- 多音乐源聚合：内置酷我、酷狗、咪咕、网易云、QQ 音乐、虾米等源（对应
src/renderer/utils/musicSdk/下的 kw、kg、mg、tx、kg、wy 等目录），还支持自定义接口源 - 桌面歌词：独立于主窗口的歌词层，支持横屏、竖屏、锁屏显示、鼠标悬停隐藏
- 数据同步服务：v2.2.0 起支持部署独立的同步服务器，实现列表、不喜欢的歌等多端同步
- 开放 API：v2.7.0 起可在本地启动 HTTP 服务，把播放器状态和控制接口开放给第三方软件
需要提醒的是：官方在 README 中明确说明，本软件的默认设置和交互不以新手友好为目标，建议首次使用时花几分钟浏览一遍设置项，这一点后文的上手步骤会帮你覆盖。
核心功能拆解
多源音乐搜索与下载
这是 LX Music 最核心的能力。你在搜索框输入歌名后，软件会从所选音乐源拉取结果，支持按歌名、歌手、专辑检索；单曲或批量选中后可以播放、加入"我的列表"或直接下载。各平台的数据适配逻辑都放在src/renderer/utils/musicSdk/目录，想看某个平台是怎么实现的可以从这里入手。
一个很实用的细节是自定义源管理：在线音频链接并非软件自己生成，而是由设置里"自定义源"配置的后端接口返回，所以某个源失效时，你可以切换或替换接口源，而不必更换软件。下载功能则由src/common/utils/download/中的下载器负责，下载中心（src/renderer/views/Download/）里可以看到任务进度并继续管理。
桌面歌词
桌面歌词是 LX Music 的招牌功能，它运行在一个独立的渲染进程里（代码位于src/renderer-lyric/），支持横向和纵向两种排版。你可以让它常驻屏幕最上层、跟随鼠标悬停自动显隐，甚至在锁屏状态下显示；字体、颜色、透明度都可以自定义。主程序与歌词窗口之间的联动逻辑在src/main/modules/winLyric/中，包括置顶循环、鼠标穿透（点击歌词区域时不遮挡下层窗口）等细节处理。
跨端数据同步
从 v2.2.0 开始，LX Music 把同步做成了一个可自部署的服务。同步相关的完整实现位于src/main/modules/sync/目录，其中client/是客户端模块（认证、数据推送、列表与不喜欢的歌两个同步域），server/则是服务端实现。如果你有一台自己的服务器，按官方同步服务的说明部署后，在软件的同步设置里填入地址，"我的列表"就能在多台设备间保持一致，数据也掌握在自己手里。
开放 API 与声音效果
v2.7.0 起，你可以在设置中启用开放 API 服务（实现在src/main/modules/openApi/），软件会在本机启动一个 HTTP 服务，提供播放状态查询、播放/暂停/切歌、音量控制、完整歌词获取等接口，还支持 SSE 订阅实时状态，适合接入自动化脚本或智能家居。另外，播放栏旁边的音效按钮（src/renderer/components/common/SoundEffectBtn/）内置了卷积混响（带多种房间预设）、EQ、变调、声像等效果，用浏览器 Web Audio 技术实现，玩点十足。
最快上手路径
- 安装软件：到项目仓库的 Releases 页面下载对应平台的安装包；如果你是 Windows 用户，解压后可在程序目录放一个
portable文件夹，软件会自动切换到便携模式，数据全部存在程序目录内，方便 U 盘携带。 - 通读一遍设置：按 README 的建议，重点看"音乐来源"（选择默认接口源）、"播放设置"（如双击歌曲是否切到当前列表播放）和快捷键配置。软件支持大量鼠标与键盘快捷操作，熟悉后效率很高。
- 完成第一次搜索并收藏：搜索框输入歌名，回车后点击播放试听；选中想长期听的歌曲，添加到"我的列表"里的一个列表。注意列表多选需要配合
Shift（连续选）或Ctrl（不连续选），这是新手最容易踩的坑。 - 打开桌面歌词：在设置里开启桌面歌词，选横屏或竖屏，调整字体与透明度，把窗口拖到你喜欢的位置，之后切歌时歌词会跟随显示。
- 配置同步（可选）：若你有服务器，部署官方同步服务后在"同步"设置中填入地址，之后新建的列表即可在多端看到。
如果你想从源码参与开发，可以执行：
git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop克隆后按仓库内的源码使用文档初始化环境，开发提交目标分支是dev。
进阶玩法
- 自定义主题：内置"绿意盎然""月里嫦娥""木叶之村"等 15 套主题，每套都是完整的 CSS 变量配色方案（定义在
src/common/theme/index.json）。设置里的主题编辑器（src/renderer/views/Setting/components/ThemeEditModal/）允许你调整各界面元素的颜色，也可以添加自定义背景图。 - 用开放 API 做自动化：接口返回 JSON 并支持字段过滤，你完全可以用十几行脚本实现"到点播放某列表""播放进度同步到 NAS 状态页"之类的玩法。
- 音效预设：音效模块支持保存卷积混响与 EQ 的自定义预设，比如给播客调一个"电话音质"（内置 filter-telephone 等音效素材就在
src/renderer/assets/medias/filters/里）。
常见问题
Q1：所有歌曲都提示"请求异常"或"无法连接到服务器"怎么办？先换源、再换网络。按官方 FAQ 的顺序：更新到最新版本 → 换一首歌试试（排除单曲问题）→ 到"设置-音乐来源"切换接口源 → 换网络（比如手机热点）。若只是 DNS 问题，把 DNS 改为自动获取或 223.6.6.6 后重启软件。
Q2：为什么打不开别人分享的歌单链接？跨源不支持打开歌单。请确认链接所属平台与软件当前选中的"歌单源"一致，必要时用右上角切换歌单源；若是分享链接失败，可先在浏览器打开再复制完整地址，或者直接输入歌单 ID。
Q3：想批量把一首歌加入多个列表，每次都自动关闭窗口很烦？在"歌曲添加"弹窗里按住Ctrl再点击列表名，窗口就不会自动关闭，可以连续添加到多个列表（v1.22.0 起支持）。
Q4：数据存在哪里？换机器会丢吗？默认路径为 Linux 的~/.config/lx-music-desktop、macOS 的~/Library/Application Support/lx-music-desktop、Windows 的%APPDATA%/lx-music-desktop（便携模式除外）。重要列表建议配合同步服务，或定期用设置中的数据备份功能导出。
写在最后
LX Music 桌面版把"多平台找歌 + 列表管理 + 桌面歌词 + 可自部署同步"这套组合，全部放进了一个免费开源的 Electron 应用里，并且对进阶玩家留了开放 API 和主题编辑器这样的扩展入口。它不追求开箱即用的傻瓜体验，但只要你按上手步骤花十分钟调一遍设置，它会成为一个长期顺手的音乐工具。
如果你愿意开始，下一步很简单：到项目仓库（gitcode 上的 lx-music-desktop）的 Releases 下载最新版安装，或者克隆仓库用npm run dev跑一遍源码，再回来对照本文的"进阶玩法"逐项体验。
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
