LXQt 2.4 主题：QSS、Qt 样式与 Kvantum

LXQt 里「主题」最容易藏着三套互不相干的系统。面板和桌面用 LXQt 的 QSS 主题，Qt 应用使用 Fusion、Breeze 或 Kvantum 这类 Qt 样式，窗口边框则归你选择的窗口管理器或 Wayland 合成器。想让 LXQt 统一，靠的是一组匹配组件，不是一份包。

本文中的三张结构图为根据官方文档制作的示意图，不是桌面实拍截图。外部官方截图资源在本次准备期间无法稳定获取，因此图中明确标为「STYLISED MOCKUP / 示意图」。

先弄清楚：这里的「主题」到底是哪一层

安装主题后「只变了一半」，通常不是 bug，而是只装了其中一层。图标、窗口装饰、应用控件和桌面 Shell 经常由不同组件负责。

一套不容易翻车的定制顺序

1. 打开「LXQt 配置中心 → 外观」。分别选择 LXQt Theme 和 Qt Style，并观察预览中到底哪部分变化。
2. 最省事的统一方法，是用 System LXQt 主题配一套能力强的 Qt 样式，如 Breeze 或 Kvantum，再调整色板。
3. 用 Kvantum 时，先把 Qt Style 选成 Kvantum，再到 Kvantum Manager 里选真正主题。和 Plasma 一样，这是两步。
4. 窗口装饰要到当前窗口管理器或合成器里匹配。Openbox 主题控制不了 KWin，Labwc 装饰也不来自 LXQt QSS。
5. 在外观设置中另选匹配的 GTK 主题，照顾 GTK 应用，然后单独验证 Flatpak。

用命令行检查和切换

GUI 适合探索，命令行适合复现。下面的命令只操作当前用户；执行前先确认主题名称在本机确实存在。

# 安装当前用户的 LXQt 主题
mkdir -p ~/.local/share/lxqt/themes
cp -a ./MyLXQtTheme ~/.local/share/lxqt/themes/

# 查看当前 LXQt 配置文件
find ~/.config/lxqt -maxdepth 2 -type f -print

# 先针对单个进程测试 Qt 样式，再决定是否修改整个会话
QT_STYLE_OVERRIDE=Fusion pcmanfm-qt
QT_STYLE_OVERRIDE=kvantum qterminal

不要把整个主题目录直接 sudo cp 到系统路径作为第一选择。用户目录更容易回退，也不会在软件包升级时留下来源不明的文件。

自己改主题时，从小处开始

先复制一份现有主题到用户目录并改名，不要直接编辑 /usr/share 里的发行版文件。第一轮只改一个颜色、一个间距或一组图标，确认加载路径和缓存都正确，再继续扩大范围。这样出现黑字配黑底时，你知道是哪一行造成的。

如果主题包有 metadata 或 index.theme，同时修改内部名称。只改目录名会产生两个界面上同名的主题，也可能让继承关系继续指向旧主题。

版本变化：旧教程为什么经常不灵

教程里的路径可能仍然存在，但主题引擎、工具包大版本或显示服务器已经变了。判断教程是否可用时，先看它针对 GTK 2/3/4、Qt 5/6、X11 还是 Wayland，再看发布时间。

常见问题

• LXQt QSS 主题不会改掉所有 Qt 应用，那个属于 Qt Style。
• 只安装 Qt 5 版 Kvantum 或样式插件，对 LXQt 2.x 的 Qt 6 会话没有用。
• 从 Openbox 换到 KWin 或 Labwc 后，即使 LXQt 设置完全一样，窗口边框也会变化。
• 暗色面板配 symbolic icon 可能让图标隐形。使用面板图标覆盖，或选择能跟随色板的图标主题。

我的建议

先把默认主题调整到能长期使用，再添加一个第三方组件。一次换完整套装很有成就感，却很难定位哪一层导致可读性、缩放或 Flatpak 不一致。最稳的方案往往是：保留桌面默认控件样式，只换配色、图标、光标和窗口装饰。

同系列文章

• KDE Plasma 主题系统
• GNOME 主题系统
• Xfce 主题系统
• Cinnamon 主题系统
• MATE 主题系统

资料来源

• LXQt theming wiki
• LXQt screenshots
• LXQt 2.4 release
• LXQt themes repository
• Kvantum