niri 配置指南一份 config.kdl 搞定 niri Wayland 合成器【免费下载链接】niriA scrollable-tiling Wayland compositor.项目地址: https://gitcode.com/GitHub_Trending/ni/niri窗口间靠鼠标拖拽越来越累双屏上窗口飞来飞去毫无秩序。niri 是一款可滚动的平铺 niri Wayland 合成器窗口自动按列排好工作区上下滚动焦点靠单键切换全程不碰拖拽。niri 配置的完整操作按四个环节组织装好、写配置、排坑、维护跟着流程走即可上手。五分钟跑起来niri 安装与首次启动大多数发行版已有现成包想拿最新功能就编译源码。第一步装构建依赖三条命令各对应一种系统# Debian / Ubuntu sudo apt-get install -y gcc clang libudev-dev libgbm-dev libxkbcommon-dev libegl1-mesa-dev libwayland-dev libinput-dev libdbus-1-dev libsystemd-dev libseat-dev libpipewire-0.3-dev libpango1.0-dev libdisplay-info-dev # Fedora sudo dnf install gcc libudev-devel libgbm-devel libxkbcommon-devel wayland-devel libinput-devel dbus-devel systemd-devel libseat-devel pipewire-devel pango-devel cairo-gobject-devel clang libdisplay-info-devel # Arch sudo pacman -S --needed base-devel clang libudev libgbm libxkbcommon egl-wayland wayland libinput dbus systemd seatd pipewire pango libdisplay-info再装好 Rustrustup 安装 stable 工具链拉取源码并编译git clone https://gitcode.com/GitHub_Trending/ni/niri cd niri cargo build --release产物在target/release/niri可直接运行也可复制到/usr/local/bin/。首次启动若找不到配置niri 会在~/.config/niri/config.kdl生成默认配置以它为基础删改即可。无显示管理器时在 TTY 里跑niri-session进会话有 GDM 之类的就直接在登录界面选 Niri。Mod键默认是 Super。一份 config.kdl 该写什么平铺窗口管理器配置核心niri 的配置是 KDL 语法保存即热加载不必重启会话。按使用意图拆主要写三块。让窗口自动归位布局参数与焦点快捷键layout {}决定窗口怎么摆gaps是窗口四周间距default-column-width是新列默认占屏宽的比例layout { gaps 16 default-column-width { proportion 0.5 } preset-column-widths { proportion 0.33 proportion 0.5 proportion 0.66 } }preset-column-widths 供Modr/ModShiftr在三档宽度间循环。快捷键写在binds {}里规律是焦点键加 Ctrl 就是对应的移动键binds { $modh focus-column left $modl focus-column right $modj focus-window down $modk focus-window up $modctrlh move-column left $modv floating-enable }让切换更顺滑动画参数与手势动画统一放在animations {}。弹簧参数里damping-ratio是阻尼1.0 为临界阻尼不抖动stiffness是刚度越小越慢段首写off全关slowdown 2.0整体放慢一倍animations { // slowdown 2.0 workspace-switch { spring damping-ratio1.0 stiffness1000 epsilon0.0001 } }触摸板三指滑切工作区、两指滑滚动平铺视图都是内置手势gestures {}里调的是触发区域和速度上限gestures { dnd-edge-view-scroll { trigger-width 60 max-speed 2500 } }dnd-edge-view-scroll 管拖拽文件时把鼠标顶到屏幕边缘继续滚视图trigger-width越大越容易触发。多屏与键鼠输出与输入映射默认 niri 会为每个接上的屏幕选推荐模式。要锁刷新率、缩放或关掉某块屏就得按连接口名写output段名字和可用模式用niri msg outputs查output HDMI-A-1 { mode 2560x1440143.912 position x1920 y0 } output eDP-1 { scale 2.0 }刷新率字符串必须和niri msg outputs的显示精确到小数点后三位写错会静默不生效。键盘与触摸板进input {}按设备类型分小节配置input { keyboard { xkb { layout cn } repeat-rate 30 } touchpad { natural-scroll } }这些选项的解析逻辑在 niri-config/ 目录全部选项的逐条说明见 docs/ 下的配置文档页。踩坑排查niri 配置高频问题一行修复症状键盘布局不生效打不出中文原因xkb 写在 niri 自己的input { keyboard { xkb {} } }里不会读系统设置。 修复配置里补上input { keyboard { xkb { layout cn } } }保存热加载立即生效。症状动画卡顿、窗口互相追原因弹簧刚度太低或所有动画同放弱显卡扛不住。 修复写animations { slowdown 2.0 }降速或animations { off }全关。症状外接显示器识别不到或刷新率不对原因output 名抄错或刷新率字符串与真实值不符。 修复先niri msg outputs查真名与真刷新率再把mode 2560x1440143.912写进对应 output 段。进阶调优与日常维护服务化、校验、更新 ⚡发行版包自带服务文件源码构建则先把resources/niri.service拷进/etc/systemd/user/然后systemctl --user enable --now niri.service大改配置后先做语法校验避免黑屏niri validate更新到最新版git pull origin main cargo build --releaseniri 承诺更新不破坏既有配置旧 config 基本可原样沿用。niri 是当下 Linux 上最活跃的可滚动平铺 Wayland 合成器之一列排得齐、工作区滚得顺、快捷键跟手。配置跑通之后翻翻 docs/ 的 wiki 或找社区聊聊还有不少值得深挖的选项。【免费下载链接】niriA scrollable-tiling Wayland compositor.项目地址: https://gitcode.com/GitHub_Trending/ni/niri创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考