niri 性能优化指南：滚动平铺 Wayland 合成器如何快速排查卡顿、监控资源并验证效果

niri 性能优化指南：滚动平铺 Wayland 合成器如何快速排查卡顿、监控资源并验证效果

【免费下载链接】niriA scrollable-tiling Wayland compositor.项目地址: https://gitcode.com/GitHub_Trending/ni/niri

快速切换工作区，niri 的切换动画开始掉帧；长文档里滚动，画面明显跟不上手指。这是一份 niri 性能优化与资源监控的实操流程：先用内置调试开关定位卡顿点，再按症状改配置，最后用数字验证优化前后的差异。

打开 3 个内置渲染调试开关，看穿 niri 卡顿排查的第一现场

niri 没有内置资源面板，但提供 3 个渲染调试开关，按下后能直接"看见"屏幕哪些区域在被重绘。把下面的键位加进~/.config/niri/config.kdl，保存后配置会自动重载：

binds { Mod+Shift+Ctrl+D { debug-toggle-damage; } Mod+Shift+Ctrl+O { debug-toggle-opaque-regions; } Mod+Shift+Ctrl+T { toggle-debug-tint; } }

三个开关分别这样读：

• 损伤区域（D）：红色区域是这一帧必须重绘的部分。正常操作时红块应该很小；空闲时仍整屏泛红，说明在持续全帧重绘，GPU 负载一定高。
• 不透明区域（O）：蓝色是声明不透明的区域，红色是透明区域。蓝区越大，混合计算越少。如果一个窗口本应不透明却大片发红，多半是应用端透明度上报的问题。
• 调试着色（T）：未被直接扫描输出的表面会染成绿色。看到大面积绿色，说明这些窗口走的是完整渲染管线而非直出。

重绘流程可以参考下图，完整选项说明见调试选项文档。⚠️ 调试选项属于实验性质，可能随时调整或移除。

解读 niri 资源监控数据：用 htop 和 btop 判断正常与异常

可视化开关只告诉你"屏幕哪块"，进程级数据还得看 CPU 和内存。运行下面两条命令，对照输出读数：

htop -p $(pgrep -x niri) ps -eo pid,cmd,%mem,%cpu --sort=-%cpu | grep niri

📊 判断锚点：idle 状态 CPU 低于 5%、内存 100–200MB 属正常；CPU 持续高于 20% 算异常。想要更好看的终端体验可以用 btop，支持鼠标操作，做压测时挂着它走全程。

niri CPU 占用高：三类常见病因与对应 KDL 配置处方

动画过多：全部关掉或只关掉卡顿的那一项

niri 默认对窗口开关、工作区切换、窗口移动都带弹簧动画，窗口越多每帧计算越重。机器带不动时先全关，看差异有多大：

animations { off }

不想彻底放弃动画，可以对单个动画写off单独关闭，或用slowdown统一放慢所有动画，减少单位时间内的计算帧数。参数细节见动画配置文档。

布局规则复杂：把 struts 和 gap 做减法

struts（外侧边距）和窗口数量越多，滚动时窗口重排的频率越高。损伤区域长期偏大时，先把边距调小、关掉一部分窗口，再对比读数。struts 的语义与示例见布局配置文档。

XWayland 兼容应用：一条命令揪出 X11 客户端

X11 应用走 XWayland，个别老客户端会触发持续重绘，表现为 niri 自身 CPU 偏高。运行xlsclients列出 X11 客户端，和你刚开的应用对一遍；有问题的应用优先换 Wayland 原生版本，背景知识见Xwayland 文档。

niri 内存占用高：先数清工作区和窗口，再收敛

内存占用随打开的窗口与工作区数量增长。先用 IPC 查当前状态：运行niri msg --help查看可用命令，查询工作区与窗口数量（客户端实现在 niri-ipc/ 目录，想脚本化定时查询可以照着写）。

收敛三步：关掉空工作区、减少每个工作区的窗口数、退出长期挂着大图纹理的应用。如果问题只出现在开发版本，先升到最新 release 再看。

niri 进阶调优清单：GPU 设备与窗口规则，按需勾选

• 多 GPU 机器（Intel+NVIDIA 混用）指定渲染设备：

debug { render-drm-device "/dev/dri/renderD129" ignore-drm-device "/dev/dri/renderD128" }

• 高负载应用加窗口规则：按 app-id 匹配，把浏览器、IDE 固定到指定工作区，减少它们触发重排的频率。匹配语法见窗口规则文档。
• 排查录屏卡顿：在 debug 块加preview-render "screencast"，让 niri 按屏幕录制的方式渲染，专门检查录制场景的性能问题。

验证 niri 性能调优效果：三项压测加内置可视化测试

🧪 先记下基线 CPU 和内存，再跑三项压测，用前后数字说话：

1. 批量开窗口：一次开一批终端，观察内存增长是否线性、关闭后能否回落；
2. 快速切工作区：在装有窗口的 3–4 个工作区之间快速来回切，看 CPU 峰值与损伤区域大小；
3. 滚动测试：在长文本窗口里快速滚动，用画面是否跟手、损伤红色区域是否克制来判定。

for i in {1..10}; do gnome-terminal & done cargo build --release -p niri-visual-tests

项目自带无头可视化测试工具 niri-visual-tests（入口在 niri-visual-tests/src/main.rs），构建后可运行它比对渲染输出，适合验证渲染相关的改动有没有回归。

留在手边的五条

• 改完配置先看损伤区域，再看进程数据，别盲调。
• 锚点：idle CPU <5%、内存 100–200MB；CPU 持续 >20% 必须排查。
• 排查顺序：关动画 → 简化布局 → 查 XWayland 应用。
• 优化后用同一组压测验证，记录前后对比数字。
• 问题持续存在时，先翻 FAQ（docs/wiki/FAQ.md）再提 issue。

【免费下载链接】niriA scrollable-tiling Wayland compositor.项目地址: https://gitcode.com/GitHub_Trending/ni/niri