10 分钟装好 niri滚动平铺 Wayland 合成器的安装与基础配置【免费下载链接】niriA scrollable-tiling Wayland compositor.项目地址: https://gitcode.com/GitHub_Trending/ni/niriniri 是一款滚动平铺 Wayland 合成器窗口按列排布在一条向右无限延伸的条带上新开窗口不会挤动已有窗口工作区在垂直方向动态扩展用滚动手势即可上下翻动。这篇文章面向第一次接触 niri 的 Linux 用户照做之后你能把 niri 装好、注册成登录会话并改好自己的第一份配置文件。三分钟快速上手优先装发行版包Fedora COPR、Arch 或 Ubuntu 25.10 源没有包就克隆仓库执行cargo build --release自己编译。把resources/目录下的niri.desktop等会话文件复制到对应系统目录让登录管理器出现 Niri 选项。注销后在显示管理器选择 Niri 登录没有显示管理器就在 TTY 里执行niri-session。按ModT开终端、ModD打开应用启动器niri 已能日常使用。用niri validate校验配置文件按自己的习惯微调~/.config/niri/config.kdl。安装前检查项目要求发行版Ubuntu 24.04、Fedora 或 Arch其他发行版走源码构建硬件支持 Wayland 的显卡虚拟机需开启 3D 加速Rust1.87 或更新源码构建时需要包管理器发行版包路径需要 sudo 权限文档官方文档在 docs/ 目录构建依赖列表见 docs/wiki/Getting-Started.md完整安装流程依赖安装步骤这一步装齐编译 niri 所需的系统库装完后cargo build不会再报缺库错误。Ubuntu/Debiansudo 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-devFedorasudo 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成功时命令正常退出、无报错输出。接着从 rustup 安装最新稳定版 Rust并用rustc --version确认不低于 1.87。源码从哪来、怎么构建这一步产出可直接运行的niri二进制文件。git clone https://gitcode.com/GitHub_Trending/ni/niri cd niri cargo build --release成功后target/release/niri出现。注意不要用--all-features构建其中包含仅供开发的特性会把 profiling 数据无限写进内存详见官方构建说明 docs/wiki/Getting-Started.md。如何注册成桌面会话这一步让登录管理器识别 niri装完后显示管理器里会出现 Niri 选项。sudo cp target/release/niri resources/niri-session /usr/local/bin/ sudo cp resources/niri.desktop /usr/local/share/wayland-sessions/ sudo cp resources/niri-portals.conf /usr/local/share/xdg-desktop-portal/ sudo cp resources/niri.service resources/niri-shutdown.target /etc/systemd/user/ systemctl --user daemon-reload成功时which niri返回/usr/local/bin/niri。怎么确认装好了这一步验证二进制和会话都能正常工作。niri --version输出版本号即安装成功。然后注销在显示管理器选择 Niri 登录如果没用显示管理器在 TTY 里执行niri-session即可。最小可用配置这一步让你拿到一份能跑通、且知道每行作用的 niri 配置。首次启动时 niri 会自动在~/.config/niri/config.kdl生成默认配置所以直接打开它改就行。下面是一份最小骨架保存后立即热加载生效layout { gaps 16 } spawn-at-startup waybar screenshot-path ~/Pictures/Screenshots/%Y-%m-%d-%H-%M-%S.pnglayout { gaps 16 }窗口之间保留 16 逻辑像素的间距。spawn-at-startup waybar启动时拉起状态栏 waybar没有装就删掉这行。screenshot-path定义截图的保存路径格式支持 strftime 时间字段。默认快捷键在 resources/default-config.kdl 的binds一节里全部有注释改绑定、加窗口规则都可以照着它写。避坑指南屏幕出现两条状态栏→ 默认配置会启动 waybar而你的桌面 shell 自带了面板 → 删掉配置里的spawn-at-startup waybar一行或执行pkill waybar。NVIDIA 显卡从 TTY 启动后黑屏→ 驱动或内核模式设置没开 → 升级支持 GBM 的 NVIDIA 驱动并在内核参数里加上nvidia-drm.modeset1处理方式见 docs/wiki/Nvidia.md。按 Super 键没有反应→ 在 TTY 下 Mod 键是 Super在窗口模式放进已有桌面里运行下 Mod 是 Alt → 按你当前的运行模式选对修饰键。构建命令卡死或内存被吃满→ 用了--all-features引入了开发用 profiling 特性 → 去掉该参数默认特性cargo build --release即可。登录管理器里找不到 Niri→ 会话文件没装对位置 → 确认niri.desktop在/usr/local/share/wayland-sessions/且niri-session脚本在PATH内。niri 单独使用时不是完整的桌面环境装好终端和启动器后建议再读一遍 docs/wiki/ 里的配置入门与 Xwayland 页面日常问题可以到官方 Matrix 频道提问。【免费下载链接】niriA scrollable-tiling Wayland compositor.项目地址: https://gitcode.com/GitHub_Trending/ni/niri创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考