Waybar 状态栏快速上手从安装到自定义的完整指南【免费下载链接】WaybarHighly customizable Wayland bar for Sway and Wlroots based compositors. :v: :tada:项目地址: https://gitcode.com/GitHub_Trending/wa/WaybarWaybar 状态栏是一款面向 Wayland 桌面的开源状态栏运行在 Sway、Hyprland 等 wlroots 系合成器上。显示哪些模块、放在哪一侧、用什么配色都由你的配置文件决定。本文从安装讲到改样式是照着做的 Waybar 配置教程也适合正在找 Wayland 状态栏 推荐的新手。它是谁适合谁用Waybar 是轻量级 Wayland 状态栏为 Sway、Hyprland、River、Niri、Mango、DWL、Wayfire 等 wlroots 系合成器设计。合成器可以理解为 Wayland 上的窗口管理器Waybar 通过它们的 IPC 通道拿到工作区、窗口和键盘状态。X11 环境无法运行它。安装步骤最快的路径是用发行版包管理器源码编译只在需要最新功能时才做。sudo apt install waybar git clone https://gitcode.com/GitHub_Trending/wa/Waybar cd Waybar meson setup build ninja -C build sudo ninja -C build install其他发行版同理替换成对应的包管理器命令即可。跑起来之后先做这几件事1. 配置文件在哪里不带配置启动时Waybar 用内置默认值运行你立刻能看到一条带模块的状态栏。要接管它创建~/.config/waybar/目录放入configJSONC 格式支持注释和style.css两个文件即可。2. 如何启用第一个 Waybar 模块配置里的modules-left、modules-center、modules-right三个数组就是模块开关写上模块名即启用。最小可用配置如下{ layer: top, modules-left: [sway/workspaces], modules-center: [sway/window], modules-right: [cpu, memory, battery, clock] }用 Hyprland 的话把sway/前缀换成hyprland/。3. 如何刷新或重启 Waybar 状态栏改完配置不用退出桌面执行killall -SIGUSR2 waybar让它重新读取配置。killall -SIGUSR1 waybar则切换状态栏的显示与隐藏。按场景挑功能盯性能CPU、内存与温度想把 CPU、内存、温度常驻在状态栏上随时确认系统有没有过热或吃满负载。用cpu、memory、temperature三个模块分别显示占用百分比、内存使用和传感器温度。各字段含义可查 cpu 模块 与 temperature 模块配置里的interval控制刷新间隔。温度超过critical-threshold时模块会加上critical样式类配合 CSS 就能变红告警。音量与电量不想离开键盘调音量、也不想等没电才发现用pulseaudio和battery两个模块解决。pulseaudio接 PulseAudio 后端显示音量并支持滚轮调节battery走 UPower 后端读取电量和充电状态选项见 pulseaudio 模块 与 battery 模块。效果是滚动鼠标直接改音量低电量时自动切换图标还能配成闪烁告警。时间与工作区看时间和切工作区是状态栏最高频的两个动作。clock显示时间并支持滚轮切换时区sway/workspaces、hyprland/workspaces把工作区列出来供点击切换。点击切换的逻辑在 hyprland workspaces 模块 里Sway 有对应实现。悬浮时钟会弹出月历鼠标一点即可在编号工作区之间跳转。外观怎么改配置文件与 CSS配置管「显示什么」。~/.config/waybar/config是 JSONC 格式可写注释。position和height定位置与高度spacing定模块间距每个模块的format决定文字内容。完整选项以 仓库默认配置 为参考。样式管「长什么样」。~/.config/waybar/style.css里*选择器定全局字体和字号单个模块用 id 选择器例如#cpu { background-color: #2ecc71; }只改 CPU 模块的背景色。把配置里reload_style_on_change设为 true保存 CSS 后自动热加载。选择器写法对照 仓库默认样式表。常见问题Waybar 状态栏不显示怎么排查先执行pgrep waybar确认进程是否存在。进程在但看不见检查layer是否为top、有没有被其他窗口盖住以及当前是不是 Wayland 会话——Waybar 只运行在 Wayland 下。启动日志报错时多半是配置文件 JSON 语法有误修正后重载即可。改了 style.css 不生效怎么办Waybar 默认不监听样式文件。改完发一次killall -SIGUSR2 waybar重载或在配置中开启reload_style_on_change实现热加载。另外确认你改的是~/.config/waybar/style.css而不是安装目录里自带的那份。模块刷新太慢怎么调快每个模块都有自己的interval秒。clock 默认 60 秒cpu 默认 10 秒battery 默认 60 秒。把值调小刷新更频繁但别设得过低部分模块要读系统文件高频轮询会抬高开销。图标显示成方块怎么回事默认样式依赖图标字体例如 FontAwesome。看到方块字先确认该字体已安装再检查 style.css 的font-family里是否包含它。下一步打开~/.config/waybar/config加一个你真正需要的模块然后执行killall -SIGUSR2 waybar看效果。每个模块的完整选项都在仓库man/目录的对应文档里卡住时直接查。【免费下载链接】WaybarHighly customizable Wayland bar for Sway and Wlroots based compositors. :v: :tada:项目地址: https://gitcode.com/GitHub_Trending/wa/Waybar创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/14 4:14:12 · 阅读 1.2k Waybar 状态栏快速上手：从安装到自定义的完整指南
Waybar 状态栏快速上手从安装到自定义的完整指南【免费下载链接】WaybarHighly customizable Wayland bar for Sway and Wlroots based compositors. :v: :tada:项目地址: https://gitcode.com/GitHub_Trending/wa/WaybarWaybar 状态栏是一款面向 Wayland 桌面的开源状态栏运行在 Sway、Hyprland 等 wlroots 系合成器上。显示哪些模块、放在哪一侧、用什么配色都由你的配置文件决定。本文从安装讲到改样式是照着做的 Waybar 配置教程也适合正在找 Wayland 状态栏 推荐的新手。它是谁适合谁用Waybar 是轻量级 Wayland 状态栏为 Sway、Hyprland、River、Niri、Mango、DWL、Wayfire 等 wlroots 系合成器设计。合成器可以理解为 Wayland 上的窗口管理器Waybar 通过它们的 IPC 通道拿到工作区、窗口和键盘状态。X11 环境无法运行它。安装步骤最快的路径是用发行版包管理器源码编译只在需要最新功能时才做。sudo apt install waybar git clone https://gitcode.com/GitHub_Trending/wa/Waybar cd Waybar meson setup build ninja -C build sudo ninja -C build install其他发行版同理替换成对应的包管理器命令即可。跑起来之后先做这几件事1. 配置文件在哪里不带配置启动时Waybar 用内置默认值运行你立刻能看到一条带模块的状态栏。要接管它创建~/.config/waybar/目录放入configJSONC 格式支持注释和style.css两个文件即可。2. 如何启用第一个 Waybar 模块配置里的modules-left、modules-center、modules-right三个数组就是模块开关写上模块名即启用。最小可用配置如下{ layer: top, modules-left: [sway/workspaces], modules-center: [sway/window], modules-right: [cpu, memory, battery, clock] }用 Hyprland 的话把sway/前缀换成hyprland/。3. 如何刷新或重启 Waybar 状态栏改完配置不用退出桌面执行killall -SIGUSR2 waybar让它重新读取配置。killall -SIGUSR1 waybar则切换状态栏的显示与隐藏。按场景挑功能盯性能CPU、内存与温度想把 CPU、内存、温度常驻在状态栏上随时确认系统有没有过热或吃满负载。用cpu、memory、temperature三个模块分别显示占用百分比、内存使用和传感器温度。各字段含义可查 cpu 模块 与 temperature 模块配置里的interval控制刷新间隔。温度超过critical-threshold时模块会加上critical样式类配合 CSS 就能变红告警。音量与电量不想离开键盘调音量、也不想等没电才发现用pulseaudio和battery两个模块解决。pulseaudio接 PulseAudio 后端显示音量并支持滚轮调节battery走 UPower 后端读取电量和充电状态选项见 pulseaudio 模块 与 battery 模块。效果是滚动鼠标直接改音量低电量时自动切换图标还能配成闪烁告警。时间与工作区看时间和切工作区是状态栏最高频的两个动作。clock显示时间并支持滚轮切换时区sway/workspaces、hyprland/workspaces把工作区列出来供点击切换。点击切换的逻辑在 hyprland workspaces 模块 里Sway 有对应实现。悬浮时钟会弹出月历鼠标一点即可在编号工作区之间跳转。外观怎么改配置文件与 CSS配置管「显示什么」。~/.config/waybar/config是 JSONC 格式可写注释。position和height定位置与高度spacing定模块间距每个模块的format决定文字内容。完整选项以 仓库默认配置 为参考。样式管「长什么样」。~/.config/waybar/style.css里*选择器定全局字体和字号单个模块用 id 选择器例如#cpu { background-color: #2ecc71; }只改 CPU 模块的背景色。把配置里reload_style_on_change设为 true保存 CSS 后自动热加载。选择器写法对照 仓库默认样式表。常见问题Waybar 状态栏不显示怎么排查先执行pgrep waybar确认进程是否存在。进程在但看不见检查layer是否为top、有没有被其他窗口盖住以及当前是不是 Wayland 会话——Waybar 只运行在 Wayland 下。启动日志报错时多半是配置文件 JSON 语法有误修正后重载即可。改了 style.css 不生效怎么办Waybar 默认不监听样式文件。改完发一次killall -SIGUSR2 waybar重载或在配置中开启reload_style_on_change实现热加载。另外确认你改的是~/.config/waybar/style.css而不是安装目录里自带的那份。模块刷新太慢怎么调快每个模块都有自己的interval秒。clock 默认 60 秒cpu 默认 10 秒battery 默认 60 秒。把值调小刷新更频繁但别设得过低部分模块要读系统文件高频轮询会抬高开销。图标显示成方块怎么回事默认样式依赖图标字体例如 FontAwesome。看到方块字先确认该字体已安装再检查 style.css 的font-family里是否包含它。下一步打开~/.config/waybar/config加一个你真正需要的模块然后执行killall -SIGUSR2 waybar看效果。每个模块的完整选项都在仓库man/目录的对应文档里卡住时直接查。【免费下载链接】WaybarHighly customizable Wayland bar for Sway and Wlroots based compositors. :v: :tada:项目地址: https://gitcode.com/GitHub_Trending/wa/Waybar创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考