启动参数——从命令行或快捷方式用特定方式启动洛雪音乐

什么是启动参数

启动参数是在启动应用程序时附加在可执行文件后面的指令，用于改变默认行为。比如：

lx-music-desktop.exe --portable

这里的 --portable 就是启动参数，告诉洛雪音乐使用便携模式（不写系统目录，数据存在程序目录内）。

常用启动参数

--portable：便携模式

最常用的启动参数。开启后：

• 洛雪音乐不写系统的 %APPDATA% 目录。
• 所有数据（歌单、设置、音源脚本、下载的临时文件）都存放在可执行文件同级目录下的 portable 文件夹内。
• 方便把整个软件装在 U 盘上，插到任何电脑上都能用，数据跟着 U 盘走。

注意：即使是绿色便携版（green.7z），默认也不是便携模式——它的数据目录还是在 %APPDATA%。只有加了 --portable 参数，或程序目录下存在 portable 文件夹（程序会自动检测），才会进入便携模式。

--disable-gpu：禁用 GPU 硬件加速

某些 Linux 发行版或老显卡驱动可能导致 Chromium 的 GPU 加速出现问题，界面白屏或渲染异常。此时可以用这个参数禁用硬件加速，强制使用 CPU 渲染：

lx-music-desktop.exe --disable-gpu

缺点是界面渲染性能会下降。只在遇到界面异常时才使用。

--user-data-dir=<路径>：指定数据目录

直接指定数据存放位置，替换默认的 %APPDATA%\lx-music-desktop。比如：

lx-music-desktop.exe --user-data-dir="D:\MyLXMusicData"

适用于想把数据存到特定位置（比如同步盘、大容量硬盘），或多个实例共享数据的场景。

--enable-features=WaylandWindowDecorations：Wayland 装饰

Linux 在 Wayland 会话中可能需要这个参数才能让窗口标题栏正常显示。

--no-sandbox：禁用沙箱

⚠️ 安全警告：禁用沙箱会降低 Chromium 的安全隔离级别。只在某些特殊的 Linux 发行版上遇到启动问题时临时使用，不建议长期使用。

Windows 快捷方式配置

如果想固定用某个参数启动（比如一直用便携模式），可以修改桌面快捷方式：

1. 右击快捷方式 → 属性。
2. 找到「目标」输入框。
3. 在可执行文件路径后面加参数：

   "C:\...\lx-music-desktop.exe" --portable

1. 保存后，双击这个快捷方式就会用 --portable 参数启动。

绿色版的便携模式自动检测

从 v1.17.0 起，绿色便携版有一种特殊行为：

• 如果程序可执行文件的同级目录下存在名为 portable 的文件夹，程序会自动进入便携模式。
• 不需要加任何启动参数。

所以如果你想把绿色版变成真正的便携版，只要在程序目录里手动创建一个名为 portable 的空文件夹就行。

macOS / Linux 启动参数

在终端中直接运行：

# macOS
open -a "lx-music-desktop" --args --portable

# Linux
./lx-music-desktop --portable

Linux 上也可以创建 .desktop 快捷方式来固定参数。

相关阅读

• 数据存储路径 —— 默认路径和便携模式的详细区别。
• 主题与界面调整 —— 界面渲染异常时可能需要用 --disable-gpu。