Hyprland 安装教程 (Arch Linux)：含 Waybar、Wofi、Fcitx5 及一键部署脚本

Hyprland 不仅仅是一个窗口管理器，它是一个基于 Wayland 的动态平铺式合成器，以其丝滑的动画、极致的可配置性和惊艳的视觉效果，在 Linux 极客圈中迅速封神。如果你厌倦了千篇一律的桌面环境，渴望一个性能与美学兼备、完全由你掌控的个性化空间，那么 Hyprland 将是你的终点站。

本指南将带您走过从安装到精通的每一个细节，在 Arch Linux 上构建一个功能完备、外观绚丽且高效实用的 Hyprland 桌面。

外链图片

〇、飞行前检查：必备环境

在起飞之前，请确保您的 Arch Linux 系统满足以下条件：

1. 一个基础的 Arch Linux 环境：已安装、可联网。
2. 安装 AUR 助手：我们将使用 yay 来安装一些社区维护的软件包。如果尚未安装，请执行：

bash sudo pacman -S --needed git base-devel git clone https://aur.archlinux.org/yay.git cd yay && makepkg -si

1. 安装登录管理器 (DM)：推荐使用 SDDM，它轻量且配置简单。

bash sudo pacman -S sddm sudo systemctl enable sddm.service

一、奠定基石：安装 Hyprland 与核心生态

一个完整的桌面体验，需要一个由核心与周边应用组成的生态系统。

• kitty: 强悍的 GPU 加速终端。
• waybar: 高度可定制的状态栏。
• wofi: 轻量高效的程序启动器。
• mako: Wayland 通知守护程序。
• grim & slurp: 截图工具。
• swww: 高效的动态壁纸应用。
• swaylock-effects & swayidle: 带特效的锁屏及空闲管理工具。
• polkit-kde-agent: 图形化权限验证代理。
• qt5ct, qt6ct, nwg-look-bin: GTK/QT 主题统一工具。
• papirus-icon-theme, nerd-fonts, noto-fonts-cjk: 必备的图标与字体包。
• dolphin: 强大的文件管理器。

安装完成后，重启电脑，在 SDDM 登录界面的左下角选择 "Hyprland" 会话，然后登录。

二、赋予灵魂：hyprland.conf 深度剖析

首次进入，您将面对一个纯黑的屏幕。现在，让我们通过配置文件赋予它生命。

创建配置文件: mkdir -p ~/.config/hypr/ && nano ~/.config/hypr/hyprland.conf

以下是一个功能完备且经过详尽注释的配置模板，您可以直接使用并逐步修改：

三、精雕细琢：配置周边应用

一个完整的桌面，需要各个组件协同工作。

1. Waybar：你的专属状态栏

创建 Waybar 配置文件: mkdir -p ~/.config/waybar && nano ~/.config/waybar/config 别忘了创建样式文件: nano ~/.config/waybar/style.css

2. Fcitx5：流畅的中文输入

安装 Rime 引擎：sudo pacman -S fcitx5-rime。配置方法与前文所述相同，确保 hyprland.conf 中的环境变量已设置，然后使用 fcitx5-configtool 添加 Rime 输入法。

3. Swaylock-effects：炫酷的锁屏

您可以创建一个脚本来简化锁屏命令： nano ~/.config/hypr/lock.sh && chmod +x ~/.config/hypr/lock.sh 然后修改 hyprland.conf 中的锁屏绑定为 bind = $mainMod, L, exec, ~/.config/hypr/lock.sh。

四、一键配置：自动化部署脚本

对于希望快速体验的用户，我编写了一个自动化脚本。它会安装所有必要的软件包，并从我的 Gitee 仓库拉取一套预配置好的 dotfiles（包括 Hyprland, Waybar, Kitty, Wofi 等）。

警告：此脚本会覆盖您 ~/.config 下的同名配置文件。请务必在纯净的环境下或备份后运行。

这个脚本将引导您完成大部分的繁琐工作，让您在几分钟内拥有一个功能齐全且美观的 Hyprland 桌面。

五、未来的资源

这套配置是我个人在长期使用中不断打磨的结果，它平衡了美观、性能与实用性。在未来，我计划将我完整的个人 dotfiles 开源到 Gitee / Github，包含更多定制化的脚本和主题，敬请期待。

学习与探索的资源：

• Hyprland 官方 Wiki (必读): ¹ ¹
• Arch Wiki - Hyprland: ² ²
• Dotfiles 社区: 在 GitHub/Gitee 搜索 hyprland-dots，汲取无限灵感。

祝您在 Hyprland 的世界里，打造出真正属于自己的那片天地！