洛雪音乐桌面版实用指南：从三分钟上手到深度定制-平芜编程栈

洛雪音乐桌面版实用指南：从三分钟上手到深度定制

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

洛雪音乐桌面版是一款基于 Electron 的开源音乐软件，多平台同时搜索、本地下载试听，适合不想为每个音乐网站装一个 App 的人，Windows、macOS、Linux 均可安装。

三分钟上手：安装与界面速览

按系统从发布页挑对应安装包：Windows 有安装版和绿色版，macOS 是 .dmg，Linux 有 deb 与 AppImage。安装版支持自动更新，绿色版需要手动覆盖升级。

打开后界面就四块：左侧导航栏（搜索、排行榜、我的列表、下载、设置），顶部是搜索框与音乐来源下拉，中间放列表，底部播放栏负责进度、音量和歌词入口。首次使用建议进设置调一遍：默认配置偏"熟练用户"风格，把来源、音质、列表机制按喜好设好（机制说明见 FAQ.md），后面用着才顺手。内置主题库里还有多套背景风格，可在设置里切换试试：

日常怎么用：搜索、播放、建歌单的主流程

30秒拿到搜索结果

按F1随时聚焦搜索框，输入后下方出现候选，方向键选中、回车即搜。右上角来源下拉可同时勾选多个平台，结果会聚合在一张列表里，方便对比哪家有这首歌。

播放机制：先弄懂试听队列

这是新手最容易卡住的点：点搜索、歌单、排行榜里的歌曲，不会自动把整列排进队列，而是先把这首歌加入"我的列表"的试听列表再播放。想连续播一批歌，就多选后整体播放：Shift+ 点击连续选，Ctrl+ 点击不连续选，Ctrl + A全选，然后右键选"播放"或"添加到列表"。另外"稍后播放"队列优先级最高，切到下一曲时会先消耗它。

多选一次建好歌单

和上面同样的多选操作，选中一批歌后右键"添加到列表"，可建新列表或加入已有列表。小技巧：在添加弹窗里按住Ctrl再点列表名，弹窗不会自动关闭，适合把同一首歌连续塞进好几个列表。

常用洛雪音乐快捷键整理：

F11：进出全屏
Ctrl + F：列表内搜索，Esc关闭，Ctrl + 回车跳转到选中歌曲并播放
歌单详情页按退格键返回歌单列表
右击播放栏封面：定位当前正在播放的歌曲

进阶玩法：三个值得记的场景

启动时直接搜索并播放

启动参数让软件一打开就执行指定动作，不用手动点。示例：

-search="突然的自我 - 伍佰" -play="type=songList&source=myList&name=默认列表"

场景：每天通勤听"默认列表"，把第二行参数写进快捷方式，打开软件就开始放。注意-play的link参数传 URL 时要先做 URL 编码；走代理则用-proxy-server="127.0.0.1:1081"。

浏览器一键唤起客户端

v1.17.0 起支持 Scheme URL，可配合浏览器脚本调用：

lxmusic://music/search/kw/周杰伦 lxmusic://songlist/open/wy/歌单ID

场景：在网页里看到想听的歌或歌单，点一下内嵌链接直接丢给客户端搜索、打开，省掉切窗口再输入的环节。

数据同步：手机歌单搬到电脑

同步功能（实验性）让 PC 端与移动端在同一局域网下实时同步列表：在 PC 端"设置-数据同步"开启，把 PC 显示的地址和端口填入移动端"设置-同步"，端口输完要按回车才生效。首次同步若两边都有列表，PC 端会弹窗让你选合并方式；连接不上时先查防火墙是否拦了端口、路由器是否开了 AP 隔离。

出问题先查这里

播放失败按"看提示语 → 确认网络 → 换来源"三步定位，各系统差异见下表：

现象	可能原因	动作
所有歌曲提示"请求异常"	当前网络无法访问接口服务器	换手机热点，或光猫断电 5 分钟再通电
提示 getaddrinfo EAI_AGAIN / 无法连接服务器	DNS 解析异常	DNS 改为 223.6.6.6 或 8.8.8.8，清系统缓存后重启软件
Windows 10/11 界面不显示	GPU 沙箱冲突	启动加`--disable-gpu-sandbox`，无效再试`-dha`
Windows 7 界面异常、黑边框	未开启 Aero 主题	开启 Aero；确不开可用`-dt`非透明模式启动
Linux 透明效果异常	硬件加速问题	用`-dha`禁用硬件加速启动
Windows 7 启动后无界面	缺少 .NET Framework 4.7.1+	安装对应运行时，必要时重启

这类参数会削弱部分安全特性或性能，没遇到问题就不要加。

安全与隐私

同步是明文传输：数据同步只在受信任的局域网内开，公共网络不要碰。
token 等同账号凭据：打开网易"我喜欢"歌单要拼 MUSIC_U token（格式歌单ID###token），拿到它的人能冒充你，不要发给任何人。
开源且无信息收集：代码可公开审查，安装包由源码构建；杀毒软件误报时，可先核对文件来源再决定去留。