引言

在 Wayland 桌面环境日益普及的今天，各种合成器（Compositor）如雨后春笋般涌现。其中，River 以其独特的“机制而非策略”（Mechanism, not policy）设计哲学脱颖而出。它是一个基于 Wayland 的动态平铺合成器，深受 dwm 和 bspwm 等 X11 窗口管理器的影响，旨在为用户提供一个极简、高性能且高度可定制的 Wayland 桌面体验。与许多内置复杂功能的合成器不同，River 将核心窗口管理功能与用户策略解耦，让用户能够通过脚本和外部工具构建完全符合个人需求的工作流。

主要特性

River 的设计理念使其具备一系列独特且强大的特性：

• 模块化的布局管理： River 的核心创新在于其不内置布局逻辑。它将窗口布局的任务委托给外部的“布局生成器”（Layout Generators）。默认的 rivertile 提供了基础的平铺功能，但用户可以自由选择或编写第三方布局器（如 river-luatile 允许使用 Lua 编写复杂布局，river-carina 也是热门选择），甚至为不同的标签（Tags）应用不同的布局策略。这种解耦设计赋予了用户无与伦比的灵活性，即使布局管理器崩溃，合成器本身通常也能保持稳定。

• 强大的标签系统： 告别传统离散的工作区，River 采用了类似 dwm 的 32 位位掩码标签系统。一个窗口可以同时拥有多个标签，用户也可以同时关注多个标签的交集。这种“集合论”式的管理方式在处理多显示器和复杂任务流时展现出更高的效率和灵活性，允许窗口在不同上下文中重叠显示，被许多资深用户评价为比传统工作区更高效。

• 脚本化配置与运行时热更新： River 的配置完全通过 riverctl 命令行工具完成。这意味着其配置文件 ~/.config/river/init 可以是任何可执行脚本（Bash、Python、Rust 等）。这种设计不仅支持根据环境（如显示器数量、电池状态）动态调整配置，更支持运行时热更新，用户无需重启合成器即可实时修改键位绑定或设置，极大地提升了配置调试的效率。

• 卓越的性能与稳定性： River 使用现代的 Zig 语言编写，并基于 wlroots 库。这使得它拥有极低的内存占用（纯净启动时通常在 20MB 至 40MB 之间）和瞬时启动速度（毫秒级）。在高刷新率显示器上，River 表现极其流畅，几乎没有输入延迟，且核心代码库精简，稳定性极高，被社区普遍认为适合作为日常生产力环境的驱动。

• 极简主义美学与高度可定制性： River 默认界面极其简洁，不内置复杂的动画或毛玻璃效果，专注于功能性。它提供了精细的窗口边框颜色、宽度和间距控制。对于追求视觉美学的用户，可以轻松配合 waybar、swaybg 等外部工具来构建个性化的桌面环境，实现“极简功能主义”的美学风格。

安装与快速入门

River 的安装通常涉及从源码编译，因为它依赖于特定的 Zig 编译器版本。

1. 准备环境： 确保系统已安装 wlroots 及其开发库，以及 meson 和 ninja 等构建工具。
2. 安装 Zig： River 对 Zig 版本有严格要求，请查阅其 GitHub 仓库 README.md 中指定的 Zig 版本，并使用 zig-bin (AUR) 或版本管理器安装对应版本。
3. 编译与安装：
   bash
git clone https://github.com/riverwm/river.git
cd river
meson build
ninja -C build
sudo ninja -C build install

4. 配置 init 脚本： 在 ~/.config/river/ 目录下创建 init 文件，并确保其具有可执行权限 (chmod +x ~/.config/river/init)。此脚本将包含所有 riverctl 配置命令，例如启动默认布局管理器：
   “`bash
   #!/bin/sh
   # 重置所有绑定，防止重复加载时冲突
   riverctl map -amount 0 normal

   启动默认布局管理器

   riverctl spawn “rivertile -view-padding 6 -outer-padding 6”

   示例：绑定 Super + Enter 启动终端

   riverctl map normal Super Return spawn “alacritty”

   示例：绑定 Super + Q 关闭窗口

   riverctl map normal Super Q close

   示例：启动 Waybar 等外部组件

   riverctl spawn “waybar”
   riverctl spawn “swaybg -i /path/to/your/wallpaper.jpg”

   … 其他 riverctl 命令和快捷键绑定

   ``
5. **启动 River：** 通常通过显示管理器（如 GDM、SDDM）选择 River 会话，或从 TTY 使用exec river` 启动。

高级用法与定制化

River 的“机制而非策略”设计为高级用户提供了无限的定制可能：

• 动态脚本化配置： 利用 init 脚本的灵活性，用户可以编写复杂的逻辑，例如根据当前连接的显示器数量动态调整布局参数，或根据时间切换桌面主题。这种能力远超静态配置文件所能提供的。
• 模态操作（Modal Keybindings）： 受 Vim 启发，River 支持声明自定义模式。例如，可以创建一个“Resize 模式”，在该模式下，H/J/K/L 键用于调整窗口大小，而非移动焦点，从而避免复杂的组合键，优化工作流。
• 自定义 Scratchpad： 虽然 River 不原生提供 Scratchpad 功能，但用户可以轻松编写脚本，结合 riverctl spawn 和 riverctl rule-add 来模拟一个下拉式终端或计算器，并控制其浮动状态和位置，甚至确保其始终出现在当前鼠标所在的显示器上。
• 动态规则与自动化： 通过 riverctl rule-add，用户可以为特定应用程序（如浮动视频播放器、通知窗口）设置自动浮动、指定标签或调整初始尺寸等规则，实现高度自动化的窗口管理，甚至强制开启或关闭服务器端装饰（SSD）。

使用场景

• 追求极致性能和资源效率的用户： River 极低的内存占用和高效的渲染使其成为旧设备、资源受限系统或对性能有严格要求的用户的理想选择。
• 习惯 dwm 或 bspwm 哲学的用户： 对于那些喜欢“一个工具只做一件事”的 Unix 哲学，并习惯于标签系统和外部布局管理的用户，River 提供了 Wayland 上的完美迁移路径。
• 喜欢通过脚本完全控制桌面的开发者和极客： River 的脚本化配置和 riverctl 接口为用户提供了前所未有的控制力，允许他们通过编程方式构建高度个性化和自动化的桌面环境。
• 多显示器、复杂任务流的用户： 灵活的标签系统和外部布局器使得 River 在管理多个显示器和处理需要频繁切换上下文的复杂任务时表现出色。

与同类软件对比

在 Wayland 平铺合成器领域，River 常被拿来与 Sway 和 Hyprland 进行比较。它们各有侧重，服务于不同的用户群体：

River 并非 Sway 或 Hyprland 的直接竞争对手，而是为那些觉得 Sway 太死板、Hyprland 太臃肿，且怀念 bspwm 灵活性或 dwm 标签系统的用户提供的第三条道路。

用户评价与社区反馈

River 在其目标用户群体中获得了高度评价。用户普遍赞赏其：

• 极致的灵活性和控制力： 脚本化配置和外部布局器让用户能够完全掌控桌面行为。
• 卓越的性能： 低内存占用和流畅的体验是其核心卖点，被誉为“Wayland 界的性能标杆之一”。
• 核心稳定性： 尽管版本号尚未达到 1.0，但其核心被认为非常稳定，极少出现崩溃，适合作为日常驱动。
• 高效的标签系统： 许多用户表示一旦习惯了 River 的标签系统，就很难再回到传统工作区模式，因为它允许更灵活的窗口组合。

然而，River 也面临一些挑战：

• 上手门槛较高： 缺乏面向新手的“入门指南”或预设模板，且需要一定的脚本编写能力，导致学习曲线较陡。
• 文档门槛： 尽管 man 手册非常详尽，但缺乏一个集中的、易于检索的知识库，对初学者不够友好。
• 生态系统依赖： 由于 River 本身功能极简，用户需要自行集成 waybar、swaybg、mako 等第三方工具来构建完整的桌面环境，这可能导致生态碎片化。

故障排除

• Zig 版本不匹配： 编译失败最常见的原因是本地 Zig 版本与 River 源码要求的版本不符。务必检查 README.md 中指定的 Zig 版本。
• init 脚本权限： 确保 ~/.config/river/init 文件具有可执行权限 (chmod +x)，且脚本内无语法错误。River 会停止解析后续指令，导致部分配置失效。
• 布局管理器未启动： 启动 River 后窗口重叠或无法自动平铺，通常是忘记在 init 脚本中显式启动布局管理器（如 rivertile）。
• NVIDIA 显卡： 作为基于 wlroots 的合成器，NVIDIA 用户可能需要设置内核参数 nvidia-drm.modeset=1 和环境变量 WLR_NO_HARDWARE_CURSORS=1 以获得更好的兼容性，但体验仍可能不如 AMD/Intel 稳定。
• 屏幕共享： 确保安装 xdg-desktop-portal-wlr 并在 init 脚本中正确设置环境变量 export XDG_CURRENT_DESKTOP=river。
• 输入设备配置： 使用 riverctl list-inputs 获取设备 ID，然后通过 riverctl input <device-id> ... 进行精细配置，例如启用触控板的“点击即点击”功能。

社区与未来展望

River 的社区规模虽小但非常活跃，主要集中在 GitHub 和 IRC/Matrix 频道。核心开发者 isaacwhitson 保持着高度的活跃，并严格把控代码质量。

• 持续的开发： 项目目前处于 0.3.x 迭代周期，已达到生产力可用状态。未来的开发重点包括重构核心代码以减少对特定 wlroots 私有 API 的依赖，并最终迈向 1.0 版本，标志着 IPC 协议的完全稳定。
• 繁荣的生态系统： 社区积极开发各种第三方布局生成器和辅助工具，如 river-carina、river-luatile，不断扩展 River 的功能边界。
• Wayland 协议支持： River 紧跟 wlroots 的更新，持续适配最新的 Wayland 协议，如 ext-session-lock-v1（用于更安全的锁屏）和 fractional-scaling-v1（分数倍缩放）。
• 提升易用性： 社区也在努力完善文档和提供更多示例脚本，以降低新用户的入门门槛，吸引更多从 X11 转向 Wayland 的用户。

总结

River 是 Wayland 世界中一个独特而强大的存在，它为那些追求极致控制、高性能和极简主义的用户提供了一个理想的动态平铺合成器。通过其“机制而非策略”的设计哲学、灵活的脚本化配置、强大的标签系统和卓越的性能，River 赋予用户构建完全个性化桌面环境的能力。如果你是一位习惯于 dwm 或 bspwm 的资深用户，或者渴望在 Wayland 上拥有完全的控制权和极致的效率，那么 River 绝对值得一试。

访问 River 的 GitHub 项目页面 (https://github.com/riverwm/river) 了解更多信息，查阅其详尽的 man 手册，并加入社区讨论，开始构建你专属的 Wayland 桌面体验。