Waybar 使用教程

2026-01-17 08:27:49作者：钟日瑜

项目介绍

Waybar 是一个高度可定制的 Wayland 状态栏，专为 Sway 和基于 Wlroots 的合成器设计。它支持多种功能，如工作区管理、绑定模式、焦点窗口名称显示等，并且可以通过自定义脚本和图像进行扩展。Waybar 可在所有主要 Linux 发行版中使用，并且拥有丰富的配置和样式选项。

项目快速启动

安装依赖

在 Ubuntu 上，可以使用以下命令安装所有相关依赖：

sudo apt install \
    clang-tidy \
    gobject-introspection \
    libdbusmenu-gtk3-dev \
    libevdev-dev \
    libfmt-dev \
    libgirepository1.0-dev \
    libgtk-3-dev \
    libgtkmm-3.0-dev \
    libinput-dev \
    libjsoncpp-dev \
    libmpdclient-dev \
    libnl-3-dev \
    libnl-genl-3-dev \
    libpulse-dev \
    libsigc++-2.0-dev \
    libspdlog-dev \
    libwayland-dev \
    scdoc \
    upower \
    libxkbregistry-dev

从源码构建

克隆仓库：

git clone https://github.com/Alexays/Waybar.git
cd Waybar

设置构建环境：
```
meson setup build
ninja -C build
```
运行 Waybar：
```
./build/waybar
```
（可选）安装 Waybar：
```
ninja -C build install
waybar
```

应用案例和最佳实践

自定义配置

Waybar 的配置文件通常位于 ~/.config/waybar/config 和 ~/.config/waybar/style.css。以下是一个简单的配置示例：

{
    "modules-left": ["sway/workspaces", "sway/mode"],
    "modules-center": ["clock"],
    "modules-right": ["cpu", "memory", "network", "battery", "tray"],
    "clock": {
        "format": "{:%Y-%m-%d %H:%M}"
    },
    "cpu": {
        "format": "CPU: {usage}%"
    },
    "memory": {
        "format": "Mem: {}%"
    },
    "network": {
        "format": "{ifname} {ipaddr} {downspeed}↓ {upspeed}↑"
    },
    "battery": {
        "format": "Bat: {capacity}% {status}"
    }
}

样式定制

可以通过 style.css 文件进行样式定制。以下是一个简单的样式示例：

* {
    font-family: "JetBrainsMono Nerd Font";
    font-size: 13px;
    color: #ffffff;
}

window#waybar {
    background-color: #282c34;
    border-bottom: 3px solid #61afef;
}

#workspaces button {
    padding: 0 5px;
    background-color: transparent;
    border-bottom: 3px solid transparent;
}

#workspaces button.focused {
    background-color: #61afef;
    border-bottom: 3px solid #ffffff;
}