Wayfire 安装配置：从源码编译到桌面的 5 步路径

Wayfire 安装配置从源码编译到桌面的 5 步路径【免费下载链接】wayfireA modular and extensible wayland compositor项目地址: https://gitcode.com/gh_mirrors/wa/wayfire还在受 X11 会话的闪烁和卡顿折磨或者只是想在 Wayland 会话里换一个更顺手的合成器Wayfire 是一个模块化的 Wayland 合成器思路来自 Compiz 的一切皆插件底层构建在 wlroots 之上。它的代码分得很干净核心模块src/core/负责主循环与场景渲染插件都是可插拔的共享库配置文件决定加载哪几个。Wayfire 安装配置这条链路其实没那么长从源码编译到桌面部署的全程我踩过的坑都标在下面了。30 秒跑通四条命令装一个能用的 Wayfire先装依赖。Ubuntu/Debian 上一条 apt 命令就能覆盖构建工具、图形库cairo、pango、libdrm、libinput 等以及 wayland-protocols 和 libwayland-devsudo apt install build-essential meson ninja-build libcairo2-dev \ libpango1.0-dev libfreetype6-dev libdrm-dev libinput-dev \ libxkbcommon-dev wayland-protocols libwayland-dev如果你不想依赖系统里已有的 wf-config 和 wlrootsmeson 配置时加-Duse_system_wfconfigdisabled -Duse_system_wlrootsdisabled两个开关即可构建系统会自动改用仓库内的子项目版本。然后拉源码、配置、编译、安装git clone https://gitcode.com/gh_mirrors/wa/wayfire cd wayfire meson build --prefix/usr/local ninja -C build sudo ninja -C build install装完wayfire --version能打出版本号就算成功TTY 里直接敲wayfire就能进桌面。需要跑老 X11 程序的话确认 xwayland 支持开着默认就是开的。第一次进去是个裸桌面面板和背景下一节补。配置文件里你真正会动的三处把仓库根目录的wayfire.ini拷到~/.config/下开始改。文件里注释很多但你会动的其实就三处。[core]下的插件清单。这是个用反斜杠续行的多行列表不用的插件删掉——blur 比较吃资源默认就没启用——需要的加回来。工作区布局。vwidth和vheight决定工作区网格大小3×3 最常见close_top_view super KEY_Q | alt KEY_F4是关闭窗口的快捷键顺手换成你的习惯键位。[core] vwidth 3 vheight 3 close_top_view super KEY_Q | alt KEY_F4各插件自己的绑定。[move]和[resize]默认 Super左/右键拖动来移动、缩放窗口[vswitch]默认 CtrlSuper方向键切工作区[command]把终端、启动器、锁屏、截图绑到具体命令上。默认值已经覆盖大部分场景改不顺手的那几个就行。桌面组件补齐让裸桌面变成桌面装个 wf-shell 就有背景wf-background、面板wf-panel、停靠栏wf-dock默认不启用默认配置里autostart_wf_shell true会自动拉起背景和面板不用手写启动项。通知接 mako熄屏和锁屏用 swayidle swaylock多显示器交给 kanshi——默认配置里这些位置都留好了把对应工具装上就能用。有 GDM、SDDM 这类支持 Wayland 的登录管理器时登录界面直接选 Wayfire 会话没有就继续在 TTY 里敲wayfire。踩坑速查表症状原因一行修复meson: command not found构建工具没装apt install meson ninja-buildGTK3 应用启动慢、.desktop 文件点不动D-Bus 环境没透传进会话[autostart]下加0_env dbus-update-activation-environment --systemd WAYLAND_DISPLAY DISPLAY XAUTHORITY改配置不生效wayfire.ini路径不对或续行漏了反斜杠确认文件在~/.config/下并检查plugins列表每行行尾都有\桌面卡顿、功耗偏高启用了吃资源的插件从plugins清单里逐个移除 blur、cube 做对比某个插件加载不到名字拼错或插件没装对着默认配置的plugins清单逐个核对想马上尝到甜头的话最值的动作是加一条 window rule比如让终端永远自动最大化、播放器永远全屏效果立竿见影规则语法看 window-rules 插件。等桌面跑顺了下一站是理解核心是怎么工作的打算写自己的插件时从插件开发文档入手plugins/目录下的现成代码就是最好的参考。【免费下载链接】wayfireA modular and extensible wayland compositor项目地址: https://gitcode.com/gh_mirrors/wa/wayfire创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考