企业官网建设流程全解析

LX Music 桌面版完整指南：免费开源多平台音乐聚合检索与播放教程

【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop

想听的那首歌，散落在不同的音乐平台里，一个 App 的歌库永远不够用？LX Music 桌面版就是为解决这类场景做的：一款免费开源的音乐检索与播放工具，把多个主流平台的资源聚合到一起，在一个应用里完成搜索、试听、下载和收藏。

它基于 Electron 与 Vue 3 开发，运行在 Windows 7 及以上、macOS、Linux 三个平台上，当前版本 2.12.2，采用 Apache License 2.0 协议开源，代码完全可查，也没有任何收费项。下面按"装好 → 找歌 → 播放 → 管理 → 排障"的顺序走一遍，帮你把它真正用起来。

三步装好 LX Music 桌面版

第一步：下载对应平台的安装包

• Windows：安装版（Setup）支持自动更新；绿色版（green）免安装，但不支持自动更新
• macOS：.dmg镜像文件
• Linux：.AppImage、.deb、.rpm、.pacman四种格式，按发行版任选其一

第二步：解决系统层面的小拦截

macOS 上如果提示"已损坏"无法启动，是缺少签名被系统拦了，在终端执行下面这行再打开即可：

sudo xattr -rd com.apple.quarantine /Applications/lx-music-desktop.app

第三步：启动并做一轮设置

官方 README 里有句实话：默认设置和 UI 并不以新手友好为目标。所以建议启动后先去"设置"里过一遍——音乐来源、音质、下载目录、主题，按自己的习惯调一遍，后续体验会顺很多。

图：LX Music 桌面版主界面，左侧导航分类，中间为歌曲列表，底部是播放控制栏

顺带一提便携模式：Windows 上如果程序目录里存在portable文件夹（v1.17.0 起），软件会自动改用这个文件夹存放数据。把绿色版塞进 U 盘就能带走，适合多机切换的人。

多音源聚合是怎么工作的

可以把它理解成"同时问好几家唱片店"：你在搜索框输入歌名，它会向内置的多个音乐源发问，谁有结果就展示谁，从而大幅提高"能听到"的概率。

软件内置了酷我（kw）、酷狗（kg）、腾讯（tx）、网易（wy）、咪咕（mg）等源的接口，各源支持的歌曲和音质不完全一样，某个源失效时可以在"设置 - 音乐来源"里切换。音质档位覆盖 128k、320k、无损 flac、24bit 无损几档，按网络情况选。

各源的请求逻辑分散在 src/renderer/utils/musicSdk/ 目录下，一个源一个文件夹，结构清晰，方便对照。

从一首歌到一整批歌的播放

LX Music 的播放机制和其他播放器不太一样，理解这一点能少走不少弯路：

• 单曲试听：在搜索、歌单或排行榜里点某首歌，它会自动先进入"我的列表"的试听列表再播放，和手动添加后播放是等价的
• 批量播放：想连续听多首，需要先多选歌曲再添加到"我的列表"去播放，或者使用"稍后播放"
• 稍后播放：这是一个优先级最高的临时队列，按"下一曲"时会先消耗它；但直接点列表切歌（不走上一曲/下一曲）会清空这个队列
• 打开在线歌单：把歌单链接或 ID 贴进输入框即可，注意不支持跨源打开——歌单源要与歌单平台一致，可以在右上角切换。网易源的"我喜欢"歌单需要登录态，v1.13.0 起支持在链接或 ID 后拼接###token的方式打开
• 更新收藏：从歌单详情页直接"收藏"进来的列表，右键列表名可以"更新"，用线上最新内容覆盖本地

下载、收藏与整理

下载功能直接把歌曲存到本地目录，后续可在下载页查看任务、继续加入列表或播放。如果下载时报ENOENT之类的目录错误，九成是下载目录没有读写权限，换一个目录即可。

"我的列表"是你真正的本地音乐库：

• 右键多选歌曲，可一次性添加到一个或多个列表（添加弹窗里按住 Ctrl 再点列表名，窗口不会关闭，方便批量加到多个列表）
• 在我的列表里按住 Ctrl 可进入"拖动模式"，直接拖列表调整顺序
• 不想再听到某首歌，可以把它加入"不喜欢的列表"，之后搜索会自动过滤掉
• 播放详情页支持 EQ 均衡、变调、混响等音效处理，相关实现在 src/renderer/components/common/SoundEffectBtn/

让快捷键替你点播放

默认快捷键都集中在 src/common/defaultHotKey.ts 里定义，常用的几个：

列表里的鼠标键盘组合更实用：

• Shift+ 点击：连续选择一段；Ctrl+ 点击：跨着选；Ctrl + A：全选；选完右键就是批量菜单
• 我的列表内按Ctrl + F打开列表内搜索，回车跳歌、Ctrl + 回车跳转并播放
• 搜索框的候选结果可以直接用方向键选，回车执行

不想装软件也想快速定位歌曲？启动参数-search="歌名"可以让软件启动后直接执行一次搜索。

换个皮肤听歌：内置主题一览

主题系统代码在 src/common/theme/，内置十几套风格各异的配色与背景，比如：

• 近墨者黑：中国风水墨山水，适合喜欢安静听感的场景
• 木叶之村：火影忍者风格，青春感拉满
• 月里嫦娥：中秋月夜意境
• 黑灯瞎火：暗色系，配月夜星空背景
• 新年快乐：传统节日红金风

图：LX Music 桌面版内置"近墨者黑"水墨主题背景

图：LX Music 桌面版内置"木叶之村"主题背景

操作路径：设置 - 主题设置，点选即可实时预览。另外右击"道法自然（英文 Auto）"主题可以单独打开亮/暗主题的调节窗口，颜色方案自己定。

进阶玩法：Scheme URL、开放 API 与数据同步

用熟之后，有三个能力值得知道：

1. Scheme URL（v1.17.0 起）：URL 以lxmusic://开头，支持搜索、打开歌单、播放歌曲等调用。配合同项目团队的油猴辅助脚本，可以在浏览器场景里直接把网页上的歌丢给 LX Music
2. 开放 API（v2.7.0 起）：开启后本地会启动一个 HTTP 服务，把播放、切歌、音量等能力暴露给第三方软件调用，适合做命令行控制或自定义控制面板，模块代码见 src/main/modules/openApi/
3. 数据同步：v2.2.0 起提供了独立的数据同步服务，有自己服务器的话可以部署一份做私人多端同步，同步服务相关代码在 src/main/modules/sync/。应用内"设置 - 数据同步"还支持与移动端在局域网内同步列表，属于实验性功能，注意传输是明文的，请在受信任的网络下使用

备份数据：软件的数据默认存放在这些位置——Linux 为~/.config/lx-music-desktop，macOS 为~/Library/Application Support/lx-music-desktop，Windows 为%APPDATA%/lx-music-desktop。换机器或重装系统前，把整个目录拷走就能带上全部列表和设置。

出问题时，按这张表排查

桌面歌词不显示的话，先确认功能已开启，再检查歌词窗口是否被遮挡；Win7 未开 Aero 时桌面歌词也会有问题，按上面 Win7 条目处理即可。

动手试试：试用与参与开发

想从源码跑起来的话，环境要求是 Node.js ≥ 22、npm ≥ 8.5.2：

git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop

克隆后进入项目目录，npm i安装依赖、切到dev分支、npm run dev启动开发模式即可。

项目欢迎 PR，几点约定：新增功能的 PR 建议先开 Issue 确认需求；修 bug 的 PR 附上修复前后对比和复现方式。另外团队在 README 里提到正在调整项目发展方向，并筹划了一个新项目 Any Listen，面向本地文件和 WebDAV 音乐播放，后续可以在仓库动态里关注。

免费、开源、跨平台、聚合多源，这几个词放在音乐软件里并不多见。装上之后先按前文的顺序把设置过一遍，剩下的交给快捷键和歌单——它会慢慢变成你日常听歌的默认入口。

【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop