洛雪音乐助手 免费音乐播放器 5 分钟上手指南
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
想听的歌在 A 家 App，无损版本在 B 家，歌词又藏在 C 家，这种来回切应用的日子，很多人都在过。洛雪音乐助手（LX Music）是一款免费、开源的桌面音乐播放器，基于 Electron 与 Vue 3 开发，把酷我、酷狗、腾讯、网易、咪咕 5 个音源聚进一个窗口。一次搜索、在线试听、离线下载，都不设会员门槛。
🎧 它能帮你解决什么
一次搜索，5 个音源一起出
它的定位是帮你"找歌"：搜索框输入歌名，聚合搜索会同时查 5 个源并把结果排在一起；某个源点不开时，用右上角的音源切换按钮换个源再搜同一首。比如搜一首新歌，甲源只有 128k，乙源能给到 flac，挑后者试听就行。
把歌单整批存到本地
在设置 → 下载打开下载功能后，按住Shift或Ctrl多选歌曲，右键即可批量下载。文件名模板、跳过已有文件、封面与歌词嵌入音频都可以配，并发上限 3 个。场景：排行榜里看中的 50 首歌，一个晚上全部进本地硬盘。
试听列表与收藏列表分开
双击搜索结果播放，属于试听，会进"试听列表"；右键 → 添加到列表，才是放进我的列表长期保留。"稍后播放"则是一个高优先级队列，加进去的歌点"下一曲"时优先消耗。这套机制项目 FAQ 里讲得很细，值得扫一眼。
📦 洛雪音乐助手安装步骤
Windows
去项目发布页拿.exe安装版，双击一路下一步；也有.7z绿色版，解压即运行，数据放在程序目录的portable文件夹里。
macOS
下载.dmg，把应用拖进"应用程序"。若打不开并提示"已损坏"，在终端执行sudo xattr -rd com.apple.quarantine /Applications/lx-music-desktop.app。
Linux
按发行版选格式：.AppImage直接运行，.deb、.rpm、.pacman走系统常规安装。
首次启动花两分钟做三件事：
- 设置 → 下载：打开下载开关，改掉保存路径（默认关闭，位置在桌面）。
- 设置 → 主题：从默认绿色换到顺眼的配色。
- 设置 → 桌面歌词：需要工作时看歌词就启用（默认关闭）。
🧭 最常用的操作路径
从搜索到连续播放
- 打开软件，按
F1聚焦搜索框。 - 输入歌名或歌手，回车。
- 双击结果试听。
- 按住
Shift（连续）或Ctrl（不连续）多选想留下的歌。 - 右键 → 添加到列表，放进"我的列表"里的某个列表。
- 打开该列表播放，
F11进全屏。
批量下载一整张歌单
- 打开歌单详情，
Ctrl + A全选。 - 右键 → 下载，挑音质（最高 flac24bit）。
- 到侧栏下载管理页看进度。
- 已下载的歌自动跳过，封面与歌词按你的设置嵌入。
🖌️ 让它更像你的
换主题和背景图
效果：内置多套配色，另有水墨、月夜等 5 张背景图可选，主色调、字号、窗口控制按钮位置都能调。 路径：设置 → 主题，选现成主题或自己自定义。
自定义全局快捷键
效果：默认全局快捷键是Ctrl+Alt+F5播放/暂停、Ctrl+Alt+←/→切歌、Ctrl+Alt+↑/↓音量，全部可换成你自己的组合。 路径：设置 → 快捷键，分本地（窗口内有效）与全局（系统范围）两组。
桌面歌词随心摆
效果：独立歌词窗口，横排竖排、字体、字号、已唱未唱颜色都能调，可拖动、锁定、置顶，全屏或暂停时自动隐藏。 路径：设置 → 桌面歌词。
🔌 进阶玩法
数据同步到手机
同一局域网下的电脑与手机可实时同步歌单，适合多设备党；实验性功能，首次用前先备份列表。
- 设置 → 数据同步开启，记下显示的地址与端口（默认
23332）。 - 手机端"同步"页填入地址和端口，点"启动同步"。
- 连不上时，检查防火墙是否拦了端口、路由器是否开了 AP 隔离。
多台电脑的话，也可以自己部署一套同步服务，把端口指向自己的服务器。
开放 API 给别的应用
v2.7.0 起提供一个本地 HTTP 服务，供第三方工具调用播放器能力，面向开发者和智能家居联动场景。
- 设置 → 开放 API打开开关。
- 默认监听
23330端口，只允许本机访问。 - 勾选"允许局域网访问"后，网络里其他设备才能调用。
用 Scheme URL 调起播放
v1.17.0 起支持lxmusic://开头的链接调用，适合从浏览器脚本里触发搜索或打开歌单。music/search传搜索关键词，songlist/open传源与歌单 ID 即可。
🩹 出问题时查这里
现象：所有歌曲提示请求异常，什么都播不了→排查：
- 先换一首歌试，确认是不是整网的问题。
- 设置 → 音乐来源切换接口；不行就换手机热点。
- 更新到最新版本。
- 怀疑 DNS 时改成
223.6.6.6或8.8.8.8，重启软件。
现象：下载失败，报ENOENT: no such file or directory→排查：
- 设置 → 下载把保存路径换成有读写权限的目录再试。
现象：Windows 10/11 界面显示不完整→排查：
- 给启动方式加参数
--disable-gpu-sandbox运行。 - 无效则依次换成
--no-sandbox、--disable-gpu直到恢复。 - 恢复后记得去掉参数，它们会禁用部分安全特性。
🗂️ 项目内部 & 参与方式
关键目录：
src/main/主进程：窗口管理、托盘、同步与 API 服务src/renderer/渲染进程：全部界面与交互逻辑src/renderer-lyric/桌面歌词窗口src/common/共享的类型与工具代码src/lang/国际化语言文件
参与贡献：克隆仓库后在dev分支开发，PR 也提交到dev；加新功能建议先开 Issue 确认需求，修 bug 附上修复前后说明和重现方式。
git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop开发环境要求 Node ≥22、npm ≥8.5.2，装完依赖后npm run dev启动。
数据存放位置：
- Windows：
%APPDATA%/lx-music-desktop - macOS：
~/Library/Application Support/lx-music-desktop - Linux：
~/.config/lx-music-desktop
🌙 写在最后
一个软件里完成搜歌、试听、无损下载和多设备同步，代码公开，数据存在本地磁盘，同步的也只是列表和设置。洛雪音乐助手没有会员档位，也没有广告位，功能都摊在上面这些章节里。现在装一个，把找了好久的那首歌搜出来吧。
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
