免费开源的 LX Music 桌面版多平台音乐聚合播放器的完整上手笔记【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop找一首歌时你多半遇到过这种情况在酷我上能放换到 QQ 音乐就灰掉了网易云那边又要单独登录另一个 App。几份会员加几个客户端折腾下来比听歌本身还累。LX Music 桌面版是面向这类场景的免费开源多平台音乐聚合播放器基于 Electron 与 Vue 3 构建把酷我、酷狗、QQ 音乐、咪咕、网易云等音源收进同一个界面按 Apache License 2.0 协议开放Windows、macOS、Linux 三个平台通吃。这篇按实际使用动线记录怎么装起来、第一次运行怎么走通主流程、哪些能力值得长期留着、卡在哪一步又该怎么绕过去。 LX Music 项目定位速览一句话概括它不是某一家平台的客户端而是一个跨平台音乐播放器的本地壳子把多个在线音源的搜索结果聚合成一份列表再配上桌面歌词、私有数据同步和主题定制这些本地能力。免费的原因在于它完全开源——代码、安装包构建过程都可以自己查看和复现不存在订阅费。它解决的核心问题就两个一个入口找到歌一份歌单数据跨设备可用。项目说明技术栈Electron Vue 3开源协议Apache License 2.0支持平台Windows 7 及以上 / macOS / Linux内置音源酷我、酷狗、QQ 音乐、咪咕、网易云可切换特色功能多源聚合搜索、桌面歌词、私有数据同步、主题定制、快捷键与批量管理 LX Music 下载与三种启动方式官方安装包推荐。到项目发布页下载对应系统的安装包Windows 有安装版Setup支持自动更新和绿色版green免安装但不支持自动更新macOS 为.dmg镜像Linux 提供.deb、.rpm、.AppImage等格式。安装后直接启动数据默认存于系统配置目录Windows 为%APPDATA%/lx-music-desktopmacOS 为~/Library/Application Support/lx-music-desktopLinux 为~/.config/lx-music-desktop。源码构建。适合想跑最新 dev 分支或改代码的人。环境要求 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便携模式。Windows 下 v1.17.0 起支持在程序目录下建一个名为portable的文件夹软件会自动改用它存放全部数据。把程序连同这个文件夹放进 U 盘到别的机器上启动即可带走完整状态不需要重装。 第一次运行从搜索到歌单的主流程第一次打开建议先花几分钟过一遍设置作者自己在项目说明里也提过默认参数偏技术向、不以新手友好为目标。之后按这条线走通主流程。先在搜索框按 F1 可聚焦输入歌名或歌手回车后结果区会合并展示多个音源的命中顶部标签可切换到具体某个音源查看。注意一个机制直接点击搜索结果播放时歌曲会被自动加入我的列表的试听列表这和先手动添加再播放是等价的想连续播放多首多选Ctrl/Shift 点击后批量添加到某个列表再播放。底部播放栏可调整音量、切换下一曲播放详情页还能查看音质选项——128k、320k、flac 乃至 flac24bit 具体可用哪些取决于当前音源对该曲的支持。播放开始后打开设置里的桌面歌词歌词会显示在独立窗口里随进度滚动也可以开启置顶让它盖在其他窗口之上字体、颜色、透明度都能在桌面歌词配置界面调整对应源码入口是 桌面歌词配置。最后做歌单管理在左侧「我的列表」里新建列表把多选好的歌曲加进去按住 Ctrl 进入拖动模式可以调整列表顺序在列表内按 CtrlF 打开列表内搜索回车定位、Ctrl回车定位并播放。在线歌单则支持收藏到本地、右键更新拉取最新内容。⭐ 三个让人留下来的能力多源聚合把找不到变成换一个试试。单一平台最大的体验问题是有版权或下架的歌曲直接搜不到。LX Music 的做法是把五个音源的结果同时拉回来同一首歌往往能标出它出现在哪些平台。用法很简单搜索框上方或设置中切换当前音源哪个源缺就换哪个。关键细节有两点一是各源对音质的支持并不一致无损选项出现与否看当前歌曲和音源二是内置了自定义源机制音源信息定义 与 音源 SDK 实现 都放在渲染层想接自己的接口可以从这里入手。桌面歌词播放之外的第二块屏幕。它解决的是边干别的边听歌还想看词的场景。在设置中开启后歌词窗口独立于主窗口支持置顶、锁定位置、鼠标移入提高透明度全局热键层面CtrlAlt0 切换显示、CtrlAlt 切换置顶、CtrlAlt- 切换锁定主窗口内 F5 播放/暂停、Ctrl←/→ 切歌全局热键默认关闭可在快捷键设置里开启。字体列表读取和渲染逻辑见 桌面歌词模块翻译与罗马音行可以调换位置。私有数据同步歌单数据自己说了算。这里分两层一是软件内置的局域网同步PC 端在设置中开启同步服务后移动端填入地址与端口即可多端实时同步列表注意官方明确标注该通道为明文传输建议在受信任网络下使用二是 v2.2.0 起团队发布的独立数据同步服务部署到自己的服务器上即成私人多端同步服务数据不出自己的机器。对有多台电脑、又想把列表和收藏握在自己手里的用户这是区别于商业客户端最关键的一条。⌨️ 用得顺手快捷键、主题与批量操作快捷键不用死记用两天就记住了。窗内默认是 CtrlF5 播放/暂停、Ctrl←/→ 上一曲下一曲、F1 聚焦搜索框F11 进全屏全局热键另加 Alt如 CtrlAlt↑/↓ 调音量。它们都可在 快捷键设置 对应界面里改默认值就在源码里查得到。主题方面内置了若干套配色如绿意盎然背景图也可以自定义仓库里自带的主题背景位于 src/common/theme/images右击主题里的道法自然还能单独打开亮暗主题设置窗口。批量管理靠鼠标键盘配合Ctrl 点选不连续、Shift 点选连续、Ctrla 全选选中后右键就是批量操作菜单——加入列表、稍后播放都能一次处理。️ 高频卡点与绕过现象所有歌曲都提示请求异常或无法连接到服务器。可能原因所在网络无法访问接口服务器或 DNS 解析异常。处理先换网络手机热点最省事仍不行就把 DNS 改为自动获取或手动指定后重启软件。现象下载歌曲时报 no such file or directory。可能原因设置的下载目录没有读写权限。处理换一个可正常读写的目录即可。现象macOS 启动时提示 App 已损坏。可能原因安装包未做系统签名被系统隔离。处理在终端执行sudo xattr -rd com.apple.quarantine /Applications/lx-music-desktop.app后重试。现象Windows 下界面显示不完整或黑屏。可能原因GPU 沙箱与显卡驱动不兼容。处理给快捷方式追加启动参数--disable-gpu-sandbox无效再试-dha禁用硬件加速这些参数会降低部分安全特性或性能没问题时不要常挂。现象在线歌单打不开。可能原因歌单平台与软件右上角显示的歌单源不一致或跨源不支持。处理先把右上角歌单源切到歌单所属平台再打开知道歌单 ID 的话可以直接输入 ID网易源我喜欢类歌单则需登录态配合。 适合谁以及边界LX Music 桌面版适合三类人不想在多个客户端和会员之间来回切换的普通听歌用户经常遇到这个平台没有的找歌困难户以及有服务器、希望歌单数据私有化同步的技术向用户。需要明确的边界是项目协议写明它仅用于技术可行性探索与研究不接受商业合作使用过程中产生的版权数据应及时清理请尊重版权、支持正版。遇到问题先去 Issues 区翻翻已有讨论没有再提交新的描述清楚系统和复现步骤即可想改代码则按贡献指南克隆仓库、切到 dev 分支开发后提 PR。项目当前版本 2.12.2仍在稳定维护最近的更新修掉了桌面歌词透明度设置不稳定、个别情况无声的问题团队另有一个面向本地与 WebDAV 音乐的新项目 Any Listen 在同步开发中。【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考