洛雪音乐助手：免费听全网音乐的完整上手指南
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
洛雪音乐助手是一款基于 Electron 和 Vue 3 开发的免费开源桌面音乐软件，它把酷我、酷狗、咪咕、网易云、QQ 音乐等多个平台的歌曲聚合到一起，你搜一次就能看到各平台的结果。它支持 Windows、macOS 和 Linux，适合不想在各家 App 之间来回切换、只想安静听歌的人。
先说一个常见场景
你喜欢的歌散落在几个平台上：A 平台有完整版，B 平台音质好，C 平台歌词全。以前你要么装好几个 App，要么为每个平台各开一份会员。用洛雪音乐助手，你只需要在搜索框输入歌名，多个音乐源会同时返回结果，哪首能播就播哪首；听过的歌可以一键收进自己的列表，不用反复去找。
洛雪音乐助手主界面：左侧是功能导航，中间是歌曲列表，底部是播放控制栏
三步跑起来：从下载到听到第一首歌
- 下载安装包。Windows 从发布页下载
.exe安装包双击安装，也有免安装的绿色压缩包；macOS 下载.dmg拖入应用程序文件夹；Linux 推荐.AppImage，解压后直接运行。 - 完成首次设置。打开软件后先同意使用协议，然后进"设置 → 音乐来源"选好接口，再到"设置 → 下载"把保存位置改成你顺手的目录（默认是桌面）。
- 听到第一首歌。在顶部搜索框输入歌名，结果列表里直接点播放。注意它的列表机制：直接播放搜索结果里的歌时，会自动把歌加入"我的列表"的试听列表，这是正常行为，不影响收听。
按需使用：你想做什么，就照这里做
一次搜遍全网资源
- 搜索框支持"歌名 + 歌手"组合，回车后用上下方向键可以选择联想结果
- 搜索结果页右上角可以切换歌曲来源，某个平台没结果时换一家继续搜
- 排行榜和歌单页也有独立的来源切换入口，歌单链接与来源要对应，打不开歌单时先检查这一点
把想留的歌收进自己的列表
- 点选歌曲后按
Shift（连续选）或Ctrl（跳着选）多选，Ctrl + A全选，macOS 上Ctrl对应Command - 选完右键"添加到列表"，可加入现有列表或新建列表，按住
Ctrl再点列表名可以一次加进多个列表 - "我的列表"里按
Ctrl + F打开框内搜索，Ctrl + 回车直接跳转到选中歌曲并开始播放
把界面换成自己喜欢的样子
- 进"设置 → 主题"，内置多款主题，"道法自然"主题还能分别设置亮色和暗色两套
- 背景图可以在预设图库里挑，比如这款水墨风背景就很耐看：
内置中国风水墨主题背景，适合喜欢清淡界面的听歌环境
- 也可以换一张明亮的二次元风背景，播放动漫歌曲时更有代入感：
内置动漫风格主题背景，色彩明亮，适合流行与动漫音乐
- 主题背景资源都在 src/common/theme/ 目录下，主色调、字体大小、进度条样式也都能在同一页调整
多台设备同步收藏
- "设置 → 数据同步"里打开开关，软件会在本机拉起同步服务（默认端口 23332），手机上填 PC 端显示的地址和端口，点"启动同步"
- 首次同步如果两边都有列表，会弹窗让你选合并方式；之后增删歌单会自动双向合并
- 前提：手机和电脑在同一局域网下，且防火墙允许该端口
进阶玩法：几条省时间的技巧
- 用快捷键代替鼠标：空格播放/暂停，
F11全屏，方向键切歌调音量，日常操作基本可以不碰鼠标 - 批量下载：列表里多选歌曲后右键"下载"，在"设置 → 下载"里提前选好消息质（128k/320k/无损）和保存目录，进度在下载管理页实时可见
- 自建同步服务：从 v2.2.0 起支持独立的同步服务，有自己服务器的话可以部署到云上，出差换网络也能同步
- 开放 API：从 v2.7.0 起，"设置"中启用开放 API 后本地会启动一个 HTTP 服务（默认端口 23330），可以写脚本控制播放、管理列表，接进自己的自动化里
- 想改源码：环境要求 Node.js 22 及以上，克隆仓库后执行
npm install，再执行npm run dev即可跑起来，仓库地址：https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
出了问题先照这张表自查
| 症状 | 排查动作 |
|---|---|
| 所有歌都提示"请求异常" | 换网络（如手机热点）重试；还是不行就去"设置 → 音乐来源"换接口 |
| 提示 getaddrinfo 或无法连接服务器 | 多为 DNS 问题，把 DNS 改为自动获取或换成223.6.6.6，改完重启软件 |
| Windows 所有歌曲提示"音频加载错误" | 打开"运行"输入inetcpl.cpl，在"连接 → 局域网设置"里取消勾选代理服务器 |
| 界面显示不完整或黑框 | 给启动方式加参数--disable-gpu-sandbox试试，无效再逐个试--no-sandbox、-dha |
| macOS 提示"已损坏，无法打开" | 终端执行sudo xattr -rd com.apple.quarantine /Applications/lx-music-desktop.app后输入密码 |
| 下载失败提示 ENOENT/mkdir | 换下载目录，一般是当前目录没有读写权限 |
| 桌面歌词不显示 | 确认"设置 → 桌面歌词"已启用，再检查歌词窗口是否被其他窗口挡住 |
更多细节可以查仓库里的 FAQ.md，版本变化看 CHANGELOG.md。
最后
洛雪音乐助手给普通人的是三样东西：一个搜索框看全平台的免费聚合搜索、自己列表加同步的数据归属权、主题快捷键随便调的可定制性。它是完全开源的 Apache 2.0 项目，安装包以发布页为准，建议优先使用官方渠道的版本。
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
