洛雪音乐桌面版：免费聚合音乐搜索播放器，从安装到跑通的完整上手指南

洛雪音乐桌面版：免费聚合音乐搜索播放器，从安装到跑通的完整上手指南

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

想找一首十年前的冷门歌？你大概会在几个音乐 App 之间来回翻找，有的要会员，有的搜不到，有的只给 30 秒试听。洛雪音乐（lx-music-desktop）把这件事简化成一步：它是一款完全免费的开源音乐搜索软件，基于 Electron 和 Vue 3 开发，聚合了酷我、酷狗、咪咕、网易、腾讯、百度等多个平台的在线音乐，一次搜索同时返回多平台的结果，搜索、试听、下载、歌单管理都在一个窗口里完成。

一分钟看懂：它是干什么的

• 定位：一个"音乐查找助手"，核心能力是聚合搜索与在线试听，不是本地曲库播放器
• 费用：0 元。无会员墙、无试听时长限制、无广告，代码以 Apache 2.0 协议开源
• 平台：Windows（7 及以上）、macOS、Linux，当前版本 2.12.2
• 音质：在线试听与下载支持 128k / 320k / flac / wav 四档，按来源可用性自动匹配
• 适合谁：受够了在各平台 App 之间切换、想免费找到并保存想听的歌的普通用户；有数据同步、开放 API 需求的话也够用

从安装到第一首歌：四个步骤

1. 下载对应平台的安装包。Windows 选 .exe 安装版（想免安装就选压缩包版，解压即用）；macOS 选 .dmg，拖入"应用程序"；Linux 推荐 .AppImage，直接运行。
2. 首次启动先过一遍设置。这个项目作者明确说过默认设置偏"老手向"，建议进 设置 后按顺序调整：
   • 设置 → 音乐来源：确认各平台来源已启用，决定你的搜索结果覆盖范围
   • 设置 → 下载：开启下载功能，把保存路径从默认桌面改到你常用的目录
   • 设置 → 快捷键：先记住默认的Ctrl+F5（窗口内播放/暂停），再按需自定义
3. 搜索并播放。按F1聚焦搜索框，输入歌名或歌手回车，结果列表按来源分列。单击任意一行即可试听，当前播放信息显示在底部播放栏。
4. 验证成功。能看到封面、进度条在走、桌面歌词（若已开启）跟着动，就算跑通了。

三个平台的差异就两处：macOS 上Ctrl组合键对应Command键；Windows 便携版只要程序目录里存在portable文件夹，所有数据（歌单、设置、下载配置）就自动存进该文件夹，整个目录拷到 U 盘就能带走。

三个你一定会用到的场景

场景一：找一首"哪里都搜不到"的老歌

你想做什么：一首只在记忆里模糊存在的歌，普通平台搜不到。

具体步骤：

1. 搜索框输入歌名 + 歌手，回车。洛雪会向多个来源同时请求，同一首歌可能在不同列出现多条结果
2. 哪一行能出声音就点哪一行试听，不同来源的音质档位可能不同（128k 到 flac）
3. 某来源无结果不用纠结，直接看别的来源那列

得到的结果：一次搜索替代了你在三四款 App 里重复输入关键词的过程。

场景二：把别人的歌单整列搬进自己库

你想做什么：刷到一个在线歌单，想把整列歌存下来反复听。

具体步骤：

1. 在歌单页点"收藏"，把整个歌单收进"我的列表"
2. 想直接播放整列：按住Shift点第一首再点最后一首（连续选），或Ctrl+A全选，右键选择添加到列表
3. 之后歌单内容有更新，右键已收藏的列表名选"更新"，本地列表会被替换为最新内容（注意是覆盖，不是追加）

得到的结果：你的本地列表和在线歌单保持同步，且可以断网听已下载的部分。小技巧：网易源的"我喜欢"歌单需要登录态，v1.13.0 起支持在歌单链接或 ID 后面拼上###和你的 token 来打开，token 从浏览器登录后的 Cookie 里取MUSIC_U。

场景三：批量下载一整张专辑

你想做什么：把喜欢的专辑离线保存，通勤没网也能听。

具体步骤：

1. 先确认 设置 → 下载 已开启，选好保存路径
2. 在列表里用Ctrl不连续点选（或Shift连续点选）要下载的歌曲
3. 右键选下载，随后在弹出的下载窗口里选音质（默认并发数 3 首，可在设置里调）
4. 到下载管理界面看进度，已存在的文件默认自动跳过，不会重复下载

得到的结果：下载文件按"歌名 - 歌手"格式命名（可自定义），默认只存音频；想要歌词可开启"下载歌词"选项一并保存 lrc 文件。

效率工具箱：快捷键与批量操作

窗口内常用键（mod在 Windows/Linux 是 Ctrl，macOS 是 Command）：

多选规则（所有列表通用）：Shift+ 点击做连续选择，Ctrl+ 点击做跳选，松开修饰键后随便点一项即可取消全部选择。选中后右键就是批量操作的入口（加入列表、下载、稍后播放等）。

几个值得打开的设置：

个性化定制：主题与界面

洛雪的主题系统不止是换色，而是"主题 ID + 自定义覆盖"两层结构，设置入口在 设置 → 主题。

• 现成主题：内置了绿意盎然、蓝田生玉、蛋雅深蓝、橙黄橘绿等多个完整配色主题，一键切换；另有"自动"模式跟随系统亮暗
• 背景图：主题可配壁纸，仓库自带几张高分辨率主题背景，比如水墨山水和动漫风格两张，直接替换--background-image即可
• 自定义项：主色调、背景色、文字色、字体与字号都能单独调，改完即时预览，不满意可以存成自己的新主题

界面层面还有几个"手感"调节：播放栏进度条样式（迷你/标准/全宽）、窗口圆角与透明（非 macOS 默认透明窗）、动画开关。桌面歌词窗口可以单独调字号、行距、颜色、透明度，支持横排/竖排两种方向，还能锁定位置、置顶显示。

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

这三项都藏在设置里，需要时再开：

• 数据同步（v2.2.0+）：项目方提供了一个独立的同步服务，把它部署到自己服务器上，就能实现多台电脑之间歌单、设置、播放记录的同步。入口在 设置 → 同步，填入服务器地址和授权码即可。
• 开放 API（v2.7.0+）：启用后本地会起一个 HTTP 服务，暴露播放控制相关接口，给其他软件或脚本调用——比如写个脚本定时切歌、或让别的程序控制播放。入口在 设置 → 开放API。
• Scheme URL（v1.17.0+）：软件注册了自定义协议，浏览器里可以通过协议链接直接唤起洛雪并执行搜索、播放等操作，官方配了油猴脚本降低使用门槛。

如果你是开发者想改代码：环境要求 Node.js ≥ 22、npm ≥ 8.5.2，克隆仓库（git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop）后执行npm install和npm run dev即可启动开发模式。代码分三块看：src/main/是主进程（窗口、系统集成），src/renderer/是界面与业务逻辑，src/common/是共享的类型和工具。

排障指南：五个高频问题

1. 所有歌曲都提示"请求异常"

• 现象：任何歌点下去都是同一个报错
• 可能原因：网络访问不到音乐接口服务器（公司/校园网限制、DNS 异常）
• 排查：先换手机热点试试，能播就是原网络问题；再进 设置 → 音乐来源 切换接口；最后更新到最新版本

2. 提示getaddrinfo EAI_AGAIN或"无法连接到服务器"

• 现象：搜索无结果或加载卡死
• 可能原因：本机 DNS 解析失败
• 排查：把 DNS 改为自动获取，或手动填223.6.6.6/8.8.8.8，改完重启软件再试

3. Windows 下所有歌提示"音频加载错误"

• 现象：搜索结果正常，一播就报错
• 可能原因：系统代理设置拦截了请求
• 排查：打开 Internet 选项（运行框输入inetcpl.cpl）→ 连接 → 局域网设置，取消代理服务器和自动配置的勾选

4. 打开在线歌单失败

• 现象：粘贴链接点打开没反应或报错
• 可能原因：歌单平台与当前"歌单源"不匹配（不支持跨源）
• 排查：确认右上角歌单源切到了歌单所属平台；仍失败就先在浏览器里打开该歌单，从地址栏复制 URL 再粘贴；知道歌单 ID 的话也可以直接输 ID

5. 某首歌有声音但没有歌词

• 现象：播放正常，歌词区域空白
• 可能原因：该来源本身没返回歌词数据，或桌面歌词没启用
• 排查：先在 设置 → 桌面歌词 确认功能已开、窗口没被遮挡；再换一条同来源之外的搜索结果试听，别的来源有歌词就是来源数据问题

自检清单

• 能在 30 秒内找到并试听一首歌，且知道结果里每一列代表哪个平台
• 知道下载保存路径在哪、如何修改，并成功下载过一首带歌词的歌
• 会用Shift/Ctrl多选，并把一批歌加入"我的列表"
• 收藏过至少一个在线歌单，并知道右键"更新"会覆盖本地列表
• 记住了F1（搜索）、Ctrl+F5（播放/暂停）、F11（全屏）三个默认键
• 换过一次主题或背景，并保存为自己的主题
• 遇到"请求异常"时知道先换网络、再切来源、最后看 DNS
• 知道数据存在哪（Windows 在%APPDATA%/lx-music-desktop，macOS 在~/Library/Application Support/lx-music-desktop，Linux 在~/.config/lx-music-desktop），换机前会备份

现在打开下载页挑个安装包，把第一首想听的歌搜出来吧——找到它的那一刻，你就知道以后不用再装第三个音乐 App 了。

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