Windows 版安装详解——Setup 安装包与绿色版两种路径

准备工作

开始之前确认：

• 系统是 Windows 10 / 11 或更高版本。Windows 7 / 8 / 8.1 的默认安装包不再支持，需要额外下载带 win7 标签的便携版。
• 磁盘上至少有 200MB 的空闲空间。
• 临时关闭杀毒软件或在安装后将洛雪音乐目录加入白名单。开源软件安装包被杀毒软件误报是常见情况。

方式一：Setup.exe 安装版（推荐）

Setup 安装版是大多数用户的选择，支持自动更新功能。

步骤 1：双击安装包

找到下载的 lx-music-desktop-v2.x.x-x64-Setup.exe，双击运行。

步骤 2：选择安装范围

安装向导会询问是「仅为我安装」还是「为所有用户安装」。选择「仅为我安装」可以避免管理员权限问题。

步骤 3：选择安装路径

默认路径是 C:\Users\<你的用户名>\AppData\Local\Programs\lx-music-desktop。建议安装在系统盘外的分区（比如 D 盘），避免系统盘空间紧张。

步骤 4：等待安装完成

安装进度通常在 1-2 分钟。

步骤 5：完成

安装完成后桌面会出现启动图标，双击即可首次启动软件。

方式二：绿色便携版

绿色版适合不想让软件写系统目录、或需要 U 盘便携使用的场景。

步骤 1：解压

下载的绿色版是 .7z 压缩包，需要 7-Zip、Bandizip 等解压软件。解压到任意位置（比如 D:\Portable\lx-music-desktop）。

步骤 2：直接运行

解压后进入目录，双击 lx-music-desktop.exe 即可启动。不需要安装过程，也不需要管理员权限。

特点

• 不写注册表。
• 数据目录与程序目录分离（默认仍在 %APPDATA%\lx-music-desktop，但可以通过在程序目录创建 portable 文件夹切换为便携模式）。
• 不支持自动更新：绿色版需要手动下载新版本替换。

Windows 7 / 8 用户

从 v2.5.0 起，默认安装包不再支持 Windows 7/8/8.1。如果必须在旧系统上使用，需要下载文件名带 win7 标签的免安装版。注意：

• win7 版可能缺失部分安全更新。
• 新版功能可能不包含在 win7 版中。
• 不建议非必要使用，尽快升级系统。

常见安装问题

安装程序没有任何反应

可能是杀毒软件拦截。尝试右键「以管理员身份运行」，或临时关闭杀毒软件再试。

安装到一半提示文件被占用

关闭正在运行的旧版洛雪音乐。如果任务管理器里看不到进程，重启电脑后立即运行安装程序。

杀毒软件提示病毒

开源软件的安装包经常被国内杀毒软件误报。建议将安装包路径和安装后的程序目录加入杀毒白名单。

安装完的第一件事

不要急着打开软件搜歌。洛雪音乐默认没有任何内置音源，第一次打开会发现搜索框输入什么都搜不到。请先阅读 音源配置板块 解决这个问题。