LX Music 桌面版：跨平台免费搜歌听歌完整指南
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
LX Music 桌面版（lx-music-desktop）是一款基于 Electron 与 Vue 3 开发的免费开源音乐播放器，当前版本 2.12.2，采用 Apache License 2.0 协议发布。它的核心工作方式很直接：输入歌名后，软件会向酷我、酷狗、QQ、网易、咪咕等内置音乐源同时发起检索，哪个源有这首歌就返回哪个源的结果，供你试听和下载。软件覆盖 Windows 7 及以上、macOS 和 Linux 三大平台。
🎯 哪些场景下它最适合你
不是所有播放器都要"全能"，LX Music 的定位是跨音乐源找歌，以下场景你会用得上它：
- 预算有限的学生：不用为不同平台分别开会员，一个应用内检索多个源
- 多设备用户：Windows 与 macOS、Linux 间切换设备，数据目录清晰、可手动迁移
- 歌单搬运者：经常需要把外部歌单导入本地管理、批量下载备份
- 副屏党：把桌面歌词放到第二块屏幕上，边写代码边看歌词
- 脚本爱好者：通过开放 API 或启动参数用命令行控制播放
它的取舍也很明确：播放列表、下载等功能齐全，但默认设置不以新手友好为目标，首次使用前建议先把设置过一遍。
📥 安装 LX Music 并播放第一首歌
选对安装包
到项目的 Releases 发布页下载对应系统的安装包（安装版仅支持 Windows 自动更新，Mac、Linux 与绿色版需手动更新）。文件名规则：
win_开头为 Windows 版，Setup 是安装版、green 是免安装绿色版.dmg为 macOS 版；.deb、.rpm、.AppImage、.pacman为 Linux 版x64、x86、arm分别对应不同系统位数与架构
启动后的四步初始设置
- 音乐来源：在"设置 → 音乐来源"里确认内置源可用，也可配置"自定义源"脚本，播放链接由所选源返回
- 音质偏好：可选
128k/320k/flac/flac24bit，按带宽和存储挑选 - 下载目录：设置一个你有读写权限的目录，避免下载时报
ENOENT错误 - 主题：挑一个顺眼的背景，后文会展开介绍
播下第一首歌
在搜索框输入歌曲名或歌手名，回车后从结果列表点选即可播放——默认行为是先自动把这首歌加入"我的列表"里的试听列表，再开始播放。注意：想连续播放多首，需要多选后加入某个列表，或用"稍后播放"排队（它是最高优先级队列，点"下一曲"时优先消耗，且不能通过"上一曲"回退）。
🔍 日常使用频率最高的功能
多选与批量操作
列表多选需要键盘配合：按住Shift点击做连续选择，按住Ctrl点击做不连续选择，Ctrl + A全选，选中后右键即可批量加入列表或下载。macOS 上Ctrl对应Command。
下载中心
选中歌曲后发起下载，支持批量任务管理；v2.12.0 起下载时默认嵌入含逐字歌词、翻译、罗马音的 Any Listen 歌词数据，已下载歌曲支持逐字滚动播放。
桌面歌词
独立窗口实时跟随音频滚动，可锁定位置、设为窗口置顶，并能调整字体（最多两种）、颜色与透明度；暂停时歌词可自动降低存在感。配合播放详情页可显示翻译与罗马音双行歌词。
主题与界面
内置主题各有出处：水墨风的"近墨者黑"、中秋月夜的"月里嫦娥"、动漫风的"木叶之村"、节日风的"新年快乐"等，主题定义集中在 src/common/theme/ 目录，还支持自定义主题配色。
⚙️ 进阶玩法：同步、API 与快捷键
自建数据同步服务
v2.2.0 起项目提供了独立的 数据同步服务。如果你有一台服务器，部署后 PC 端与移动端可实时同步歌曲列表，数据完全掌握在自己手里。注意传输为明文，请在受信任的网络下使用。
开放 API 控制播放
v2.7.0 起启用该功能后，软件会在本地启动一个 HTTP 服务（实现位于 src/main/modules/openApi/），供第三方软件调用。v2.12.0 后接口还覆盖了音量、静音、播放进度与完整歌词获取，适合做自动化脚本或自定义控制面板。此外 v1.17.0 起支持 Scheme URL，可用浏览器场景唤起播放。
默认快捷键一览
| 操作 | 默认按键 |
|---|---|
| 聚焦搜索框 | F1 |
| 播放 / 暂停 | Ctrl + F5 |
| 上一曲 / 下一曲 | Ctrl + ←/Ctrl + → |
| 全局显示桌面歌词 | Ctrl + Alt + 0 |
| 全局音量加减 | Ctrl + Alt + ↑/Ctrl + Alt + ↓ |
所有快捷键都可在设置里重新绑定，另支持"快进/快退 5 秒"自定义键。
便携模式与数据备份
Windows 平台下，若程序目录存在portable文件夹，软件会自动改用该目录存放数据，适合 U 盘携带。默认数据目录：Linux 为~/.config/lx-music-desktop，macOS 为~/Library/Application Support/lx-music-desktop，Windows 为%APPDATA%/lx-music-desktop。建议每月备份一次该目录，尤其是"我的列表"。
🩺 按症状快速排错
| 症状 | 处理方向 |
|---|---|
| 所有歌曲提示"请求异常" | 先换网络（如手机热点），再检查 DNS 与代理设置，最后确认已是最新版本 |
| Windows 全部歌曲"音频加载错误" | 关闭 Windows Internet 选项中的代理设置 |
| Win10/11 界面显示不完整 | 给启动方式加--disable-gpu-sandbox参数，无效再逐个尝试-dha、--disable-gpu |
| Windows 7 界面异常或闪烁 | 开启 Aero 主题；或加-dt参数以非透明窗口启动 |
| 打不开外部歌单 | 确认歌单源与标签一致；网易源"我喜欢"需拼上###token才能打开 |
下载失败提示ENOENT | 更换下载目录（多为目录无读写权限） |
| macOS 提示"已损坏"无法启动 | 终端执行sudo xattr -rd com.apple.quarantine /Applications/lx-music-desktop.app并输入密码 |
更多细节可查阅仓库内的 FAQ.md 与 CHANGELOG.md。
🌱 贡献代码与项目动向
项目欢迎 PR，但提交流程有约定：新功能建议先提 Issue 讨论必要性；修复 bug 需附修复前后说明与重现方式；开发基于dev分支进行，PR 也提交到dev分支。
开发环境要求 Node.js ≥ 22、npm ≥ 8.5.2，克隆仓库后切换分支即可开工：
git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop团队同步在推进新项目 Any Listen，目前支持列表跟随本地文件自动更新、加载并播放 WebDAV 上的歌曲，有播放本地或服务器音乐需求的用户可以关注。最后提醒一句：本项目仅用于技术学习交流，使用时请尊重音乐版权、支持正版创作。
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
