niri 完整配置指南：三步跑通可滚动平铺 Wayland 桌面

niri 完整配置指南三步跑通可滚动平铺 Wayland 桌面【免费下载链接】niriA scrollable-tiling Wayland compositor.项目地址: https://gitcode.com/GitHub_Trending/ni/niriniri 是一个可滚动平铺的 Wayland 合成器窗口按列排布在一条向右无限延伸的带子上打开新窗口不会挤压已有窗口左右滚动就能翻遍全部窗口。工作区则像 GNOME 一样在垂直方向动态生成每台显示器各自独立一套。配置文件是一份 KDL 格式的config.kdl支持热重载改完保存立即生效。第一天安装并启动niri 本身不是完整的桌面环境只是窗口管理核心通常搭配一个桌面壳如 Quickshell 系方案使用。获取方式有三条路场景做法包管理器优先用发行版包Fedora COPR、Arch、Ubuntu 25.10 仓库均有桌面壳一键装按官方 Getting-Started 页给出的组合命令安装登出后在显示管理器里选 Niri 登录自己编译装好依赖和 Rust 后cargo build --release从源码构建时先克隆仓库git clone https://gitcode.com/GitHub_Trending/ni/niri cd niri cargo build --release注意不要加--all-features构建部分 feature 只用于开发其中一个会让 profile 缓冲区无限增长直到内存耗尽。没有显示管理器时在 TTY 里执行niri-sessionsystemd/dinit 环境或niri --session启动。首次登录后记住几个默认快捷键TTY 下 Mod 即 Super 键ModT打开终端ModD打开应用启动器ModH / ModL / ModJ / ModK聚焦左、右、下、上的列或窗口Ctrl 叠加上面这些键 把窗口搬过去而不是只移动焦点ModU / ModI上下切换工作区ModShiftF全屏ModV平铺/浮动互切PrtSc区域截图选区后按 Space 保存ModShiftE退出ModShift/随时调出快捷键速查表认识 config.kdl一处配置热重载生效niri 从~/.config/niri/config.kdl读配置找不到时回退到/etc/niri/config.kdl两者都没有则自动生成默认配置。KDL 语法只需三点就够上手//是注释/-section可整段注释开关类选项直接写名字即开启注释掉即关闭例如focus-follows-mouse同名区块大多不能重复按设备名区分的区块如多个output除外最关键的性质保存即生效。键绑定、输出模式、窗口规则全部热重载不需要重启合成器。改乱了也不怕跑一条命令体检niri validate它会解析配置文件并列出所有错误——niri 出问题时界面也会提示你执行这条命令。最小可用配置示例其余全部走默认值layout { gaps 4 } input { focus-follows-mouse }进阶定制布局、动画、快捷键 列宽与窗口大小列宽不必手算。默认绑定了ModR / ModShiftR循环预设列宽Mod / Mod-以 10% 步进调节列宽ModShift / ModShift-调窗口高度。想让某类应用常驻某一列宽用window-rule按标题或类名匹配即可。动画怎么调所有动画都集中在animations {}区块每项可以独立设成off也可以在顶部写off一刀全关、写slowdown统一减速。默认值参考窗口打开是 150ms 的ease-out-expo窗口移动、切换工作区走弹簧spring曲线。嫌慢就加animations { slowdown 0.5 // 数值小于 1 是加速 }绑定滚轮和鼠标不只是键盘。滚动绑定会随natural-scroll设置自动换方向cooldown-ms可限流binds { ModWheelScrollDown cooldown-ms150 { focus-workspace-down; } ModWheelScrollUp cooldown-ms150 { focus-workspace-up; } }按下的绑定默认会重复触发不想要就加repeatfalse。忘了某个键的 XKB 名字时用wev这类工具按一下就能看到。窗口规则圆角与边框想给所有窗口加圆角加一条窗口规则即可window-rule { geometry-corner-radius 12 clip-to-geometry true }多屏、全屏与工作区每台显示器有独立的窗口带窗口绝不会溢出到相邻屏幕拔掉显示器它的工作区会迁移走重新接上又迁回来。全屏与最大化的效果可参考官方文档截图输出配置按设备名写区块同一块屏的分辨率、缩放、位置都能定死。需要接了外接屏就换一套布局这类联动逻辑官方推荐搭配 Kanshi 工具实现它通过 IPC 与 niri 通信可在配置里用spawn-at-startup /usr/bin/kanshi拉起。三指手势在gestures {}区块配置支持触摸板与鼠标滑动切列、切工作区。高频问题排坑 配置报错、界面弹黑框黑框提示的就是niri validate。按提示修到无错误为止binds区块不会被自动补默认值删掉它就等于没有快捷键别误删。透明窗口透出色带 / 想关掉应用自带的圆角边框CSD在配置顶层启用prefer-no-csd再重启应用niri 会请求窗口放弃自绘边框焦点环也会改画在窗口外围。副作用是鼠标边缘拖拽 resize 消失改用Mod右键拖动调整。NVIDIA 黑屏或显存占用高需要较新的驱动支持 GBM并在内核启动参数加nvidia-drm.modeset1显存问题按官方 Nvidia 文档打补丁。混合显卡笔记本外接屏卡顿可试debug区块的render-drm-device指定独显渲染代价是更费电。要跑 Steam、旧版 Discord 等 X11 应用niri 从 25.08 起内置 xwayland-satellite 集成按官方 Xwayland 页启用即可Electron 应用大多加个启动参数就能原生跑 Wayland。登录后有两条状态栏装了桌面壳自带一条 bar而 niri 默认配置还会spawn-at-startup waybar删掉这行或先pkill waybar即可。锁屏死了留下红屏红屏是 niri 的锁屏背景。切到别的 TTY 向WAYLAND_DISPLAY手动拉起 swaylock或给锁屏绑定加allow-when-lockedtrue以便在红屏上直接再触发。验证与日常维护 ✅养成两个习惯就能省心改完配置跑一次niri validate。热重载虽然友好但解析失败时 niri 会弹错误通知并保留旧配置提前验证更稳。升级时先看默认配置的 diff。官方承诺发布版本之间不破坏已有配置binds除外——升级后扫一眼niri validate的输出即可。想深入细节时从仓库内这两处入手官方文档docs/wiki 覆盖每个配置区块配置解析模块 可以看到每个选项在代码里如何生效。延伸阅读Workspaces 页讲透工作区行为Window-Rules 页列出全部窗口规则。【免费下载链接】niriA scrollable-tiling Wayland compositor.项目地址: https://gitcode.com/GitHub_Trending/ni/niri创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考