洛雪音乐助手完全指南免费开源一个播放器聚合搜索全网音乐【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop出门前你想把一首歌塞进耳机却发现它在酷狗上有、伴奏在咪咕有、歌词在别家全。手机上装着三个 App同一时刻只能打开一个。洛雪音乐助手把这件事合并成了一步输入歌名一次搜遍酷我、酷狗、咪咕、QQ 音乐、网易云等多个平台。这是一款完全免费、开源的桌面音乐播放器主打全网音乐聚合没有会员墙也没有广告位。项目速写洛雪音乐助手lx-music-desktop的定位很直接免费音乐播放器 全网音乐聚合。它用 Electron 30 做外壳、Vue 3 做界面代码以 Apache-2.0 协议开源Windows 7 及以上、macOS、Linux 三大平台都能跑。{: alt洛雪音乐助手主界面全网音乐聚合搜索与播放 }上面这张主界面截图里左侧是导航栏搜索、歌单、排行榜、下载、设置中间是歌曲列表底部是播放控制条。它把「查找歌曲」当作第一能力搜索、歌单、排行榜、试听列表、自定义列表、下载管理都围绕同一套界面组织。多个音乐源kw / kg / tx / wy / mg的适配逻辑集中在 src/renderer/utils/musicSdk/ 目录下想确认某个平台的支持情况直接看对应文件夹即可。功能全景先给你一张地图进入正文前先把核心能力一次列全后面按使用场景逐块展开能力一句话说明聚合搜索一个搜索框同时查询多个音乐源结果合并展示多源切换设置里可启用/停用各音乐源某源没结果时换一个继续免费开源无 VIP、无广告、无时长限制代码公开可查主题自定义内置多套主题背景颜色、字体、背景图可自由调快捷键本地/全局两套快捷键可自定义按键组合批量下载列表多选后整批保存支持 128k / 192k / 320k / flac / wav 等音质桌面歌词独立歌词窗口支持横排与竖排两种样式数据同步v2.2.0 起支持自建同步服务多设备共享歌单与设置开放 APIv2.7.0 起本地启动 HTTP 服务供第三方软件调用播放器接口Scheme URLv1.17.0 起支持从浏览器等外部场景直接唤起播放音质档位定义在 src/common/constants.ts 中下载与在线播放共用同一套档位体系所以下载时选什么、列表里能选什么两边是对得上的。安装与首次配置Windows下载.exe安装包双击后一路「下一步」完成安装想要便携用法就下载.7z压缩包解压即用——程序目录里只要存在portable文件夹所有数据就会自动存进去U 盘带走也不丢。macOS下载.dmg镜像把应用拖进「应用程序」文件夹和普通 Mac 应用一样使用。Linux按发行版选格式即可.AppImage推荐度最高无需安装直接运行apt 系可以选.deb其他发行版还有rpm、pacman包可选。装完之后花两三分钟做这三件事体验会立刻不一样打开设置 → 音乐来源把想用的音乐源全部启用搜索覆盖范围最大定好下载目录设置 → 下载里指定保存位置后续批量下载不用每次选过一遍快捷键设置 → 快捷键里确认默认组合或改成你习惯的按键。默认快捷键在 src/common/defaultHotKey.ts 中可以找到定义窗口内CtrlF5macOS 为CmdF5播放/暂停、Ctrl←/→切歌、F1聚焦搜索框。场景化实战四个高频用法场景 A日常在线听歌日常最核心的动作就是「搜一首、听一首」。在顶部搜索框输入歌名或歌手结果会合并来自多个源的同名歌曲每首歌会标出可用音质和大小方便你挑音质最好的版本。如果某个平台没收录直接在列表里换一条来源点播放不用重新搜。几个提效小动作按F1直接聚焦搜索框连续搜歌不用摸鼠标播放中按CtrlF5暂停/继续Ctrl←、Ctrl→切歌播放详情页里可以看封面、歌词和音效设置均衡器、混响等都在播放控制区。场景 B离线收藏与批量下载想留一整张专辑或一个歌单流程固定四步在搜索、歌单或自己的列表里用Shift连续选或Ctrl跳着选多选歌曲CtrlA可全选右键选中项选择下载确认保存路径与音质标准 128k/192k、高品 320k、无损 flac/wav在「下载」页签看实时进度完成后自动归入下载列表可直接播放或加进歌单。下载功能的管理界面在 src/renderer/views/Download/失败的任务可以单独重试不用整批重来。场景 C个性化外观主题资源集中在 src/common/theme/ 目录内置多套完整主题也支持你自定义主题背景内置水墨、动漫、月夜等多种风格的整屏背景界面颜色主色调、背景色、文字颜色都可以单独调字体与字号按屏幕分辨率调整歌词和列表的显示大小布局部分界面元素的位置可自由摆放。改到满意之后建议保存成自定义主题之后换电脑导入即可。场景 D效率与自动化键盘党可以把操作压缩到几乎不碰鼠标F11全屏切换、CtrlA全选、CtrlF列表内搜索在我的列表里直接框内找歌、Esc取消选中。所有组合都能在设置里改全局快捷键甚至允许你在别的软件抢焦点时也能控制播放。进阶玩法看下一节的「进阶联动」开放 API 和 Scheme URL 让洛雪音乐助手可以被外部脚本与工具调用这是它和普通播放器拉开差距的地方。生态扩展进阶联动两件事值得单独说因为它们把洛雪音乐助手从「单机播放器」扩展成了「可接入你工作流的一端」。自建数据同步服务。从 v2.2.0 起官方发布了独立的数据同步服务部署到自己的服务器上后多台设备之间可以同步歌单、设置和播放记录。客户端在设置里填上你的服务器地址即可。同步服务的客户端与服务器实现分别在 src/main/modules/sync/client/ 和 src/main/modules/sync/server/代码是开源的部署前可以自行审计。开放 API。从 v2.7.0 起启用该功能后软件会在本地启动一个 HTTP 服务暴露播放器相关接口。典型用法写个定时脚本到点自动放起床音乐、在智能家居联动里调用播放/暂停、或让自己的小工具直接读取当前播放状态。相关类型定义见 src/common/types/open_api.d.ts。另外 v1.17.0 起的 Scheme URL 支持浏览器一键唤起播放器配合外部页面使用很方便。开发者视角代码结构按 Electron 的经典三层划分外加一个独立的歌词窗口渲染进程src/main/主进程——窗口管理、托盘、全局快捷键、同步服务、桌面歌词窗口src/renderer/渲染进程——用户界面、状态管理、各音乐源 SDK 适配src/common/主进程与渲染进程共享的工具、常量、类型定义、主题src/lang/国际化语言文件简中、繁中、英文。本地开发环境搭建只需四步确认 Node.js ≥ 22、npm ≥ 8.5.2克隆仓库git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop执行npm install安装依赖执行npm run dev启动开发模式。项目欢迎 PR惯例是新功能建议先提 Issue 对齐需求修 bug 请附复现方式和前后对比。更新历史可查 CHANGELOG.md。排障手册按「症状 → 排查步骤」来照着走基本能覆盖绝大多数问题症状 1歌曲无法播放提示请求异常或音频加载错误先换一首歌试试——只有一首不行多为版权或源的问题全部不行则是网络问题到「设置 → 音乐来源」切换其他音乐源再播换网络环境手机热点最方便验证确认软件是最新版本不是再更新一次Windows 上若全部提示「音频加载错误」检查 Internet 选项里的代理设置是否误开。症状 2桌面歌词不显示或位置不对设置 → 桌面歌词里确认功能已启用歌词窗口可能被其他窗口盖住切一下焦点或拖动它部分歌曲本身没有歌词数据属正常现象仍异常时重启软件让歌词窗口重新创建。症状 3软件启动失败核对系统要求Windows 需 7 及以上卸载后重装最新版查看程序日志找具体报错日志文件在下方数据目录中。数据目录与备份排障和迁移都用得上平台默认数据位置Linux~/.config/lx-music-desktopmacOS~/Library/Application Support/lx-music-desktopWindows%APPDATA%/lx-music-desktop便携模式下为程序目录的portable文件夹建议至少每月备份一次这三个东西自建歌单列表、下载目录里的本地音乐、设置里的个性化配置。换机迁移时把整个数据目录拷过去即可软件会自动识别。一句话总结洛雪音乐助手是「免费 开源 全网音乐聚合」的桌面播放器把分散在多个平台的歌收进同一个搜索框。如果你受够了在 App 之间来回切换现在就可以装一个试试——从搜索第一首歌开始它就能省掉你三个 App。【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考