Hyprland 桌面
窗口、状态栏与主题，一套桌面环境的组成。
专题与文章目录
1 个专题文章
Hyprland 是 Wayland 合成器，负责窗口、输入、显示器和合成显示。完整桌面还需要启动器、通知、锁屏、音频控制、输入法与应用集成。理解这些组件如何连接，比先复制一大套外观配置更有助于长期维护。
本系列面向已经能登录 Linux 图形会话、能够编辑配置和查看用户服务日志的读者。安装与显卡驱动按发行版文档处理；本文重点是安装后的组织、验证与故障恢复。
先看职责与依赖
| 组成 | 负责什么 | 故障时先看哪里 |
|---|---|---|
| Hyprland | 窗口、显示器、键位、合成 | 配置错误、hyprctl 状态 |
| Quickshell 外壳 | 顶栏、抽屉、通知等界面 | QML、外壳配置、用户服务日志 |
| 主题流程 | 调色板、模板文件、应用刷新 | 输入图片、模板输出、重载动作 |
| 桌面服务 | 输入法、音频、认证、portal | 对应服务、会话环境、D-Bus |
| 空闲与锁屏策略 | 锁屏、熄屏、休眠衔接 | 策略所有者、抑制条件、恢复动作 |
壁纸变了而终端没变色，应查主题流程；顶栏消失但窗口还能移动，应查外壳。将不同故障都归因到“Hyprland 配置坏了”，容易扩大修改范围。
当前实例与历史方案
2026-09-15 核对的本地配置采用 Hyprland 0.55 系列 Lua 语法，Caelestia Shell v2.4.0 构建在 Quickshell 上。桌面外壳负责顶栏、壁纸与锁屏等功能，应用主题通过额外 hook 调用 Matugen 同步。配置与服务文件核对不等于本次重新登录并实测了全部桌面功能。
旧文中的 illogical-impulse（ii）外壳、生成 colors.json 的路径、hyprpaper/hyprlock 和双 hypridle 实例属于早期组合。它们仍有参考价值，但不能与当前 Caelestia 的配置文件混合使用。Waybar 保留为独立备用状态栏，当前模板示例不要求主外壳存在。
阅读顺序
- Lua 与多屏配置：先让窗口、显示器和基本快捷键工作，理解缩放后的逻辑坐标。
- Quickshell 与 Caelestia：从一个独立小组件理解 QML，再定位完整外壳中的配置与服务。
- 配色生成与分发：区分主题输入、模板输出和运行中应用的刷新。
- 锁屏、空闲与配套服务：确定每项功能的唯一管理者，验证抑制与恢复。
- 会话与桌面集成排障：处理 PATH、用户服务、portal、输入法和音频。
- Waybar 配置与主题：作为备用状态栏或独立轻量方案阅读。
已有桌面时按任务跳读，不必更换主外壳来完成其他章节。
建立可恢复的最小环境
修改复杂配置前，确认三件事：可以进入另一个 TTY 或远程终端，可以编辑并恢复配置文件，知道当前会话怎样启动。先保存可用配置，再分阶段增加组件。
最小验证路径是：登录 → 打开终端 → 切换窗口 → 检查显示器 → 注销并重新登录。然后加入外壳、输入法、音频和主题。锁屏与休眠要单独测试，不能用“顶栏显示正常”代替它们的验证。
尽量让每个常驻组件只有一个启动来源。如果外壳既由 Hyprland 自动启动，又由用户服务拉起，可能出现重复面板、IPC 指向错误实例或旧进程保留失效的 Wayland socket。
主题统一到什么程度
同一壁纸可以为外壳与应用提供共同的配色输入，但各应用使用不同角色、模板和刷新机制。备用 Waybar 可以保持静态主题，某些应用也可能只在重启后更新。
因此，维护目标应是“颜色来源与分发规则清楚”，而不是承诺所有界面始终完全一致。发现某个应用没有更新时，可以沿配色链定位，而无需重新配置整个桌面。
完成本系列后，应能画出自己的组件关系，指出每个进程由谁启动、读哪些文件、从哪里看日志，以及哪些配置是本机硬件特例。