
niri 完整配置指南三步跑通可滾動平鋪 Wayland 桌面【免費下載鏈接】niriA scrollable-tiling Wayland compositor.項目地址: https://gitcode.com/GitHub_Trending/ni/niriniri 是一個可滾動平鋪的 Wayland 合成器窗口按列排布在一條向右無限延伸的帶子上打開新窗口不會擠壓已有窗口左右滾動就能翻遍全部窗口。工作區(qū)則像 GNOME 一樣在垂直方向動態(tài)生成每臺顯示器各自獨立一套。配置文件是一份 KDL 格式的config.kdl支持熱重載改完保存立即生效。第一天安裝并啟動niri 本身不是完整的桌面環(huán)境只是窗口管理核心通常搭配一個桌面殼如 Quickshell 系方案使用。獲取方式有三條路場景做法包管理器優(yōu)先用發(fā)行版包Fedora COPR、Arch、Ubuntu 25.10 倉庫均有桌面殼一鍵裝按官方 Getting-Started 頁給出的組合命令安裝登出后在顯示管理器里選 Niri 登錄自己編譯裝好依賴和 Rust 后cargo build --release從源碼構(gòu)建時先克隆倉庫git clone https://gitcode.com/GitHub_Trending/ni/niri cd niri cargo build --release注意不要加--all-features構(gòu)建部分 feature 只用于開發(fā)其中一個會讓 profile 緩沖區(qū)無限增長直到內(nèi)存耗盡。沒有顯示管理器時在 TTY 里執(zhí)行niri-sessionsystemd/dinit 環(huán)境或niri --session啟動。首次登錄后記住幾個默認快捷鍵TTY 下 Mod 即 Super 鍵ModT打開終端ModD打開應用啟動器ModH / ModL / ModJ / ModK聚焦左、右、下、上的列或窗口Ctrl 疊加上面這些鍵 把窗口搬過去而不是只移動焦點ModU / ModI上下切換工作區(qū)ModShiftF全屏ModV平鋪/浮動互切PrtSc區(qū)域截圖選區(qū)后按 Space 保存ModShiftE退出ModShift/隨時調(diào)出快捷鍵速查表認識 config.kdl一處配置熱重載生效niri 從~/.config/niri/config.kdl讀配置找不到時回退到/etc/niri/config.kdl兩者都沒有則自動生成默認配置。KDL 語法只需三點就夠上手//是注釋/-section可整段注釋開關(guān)類選項直接寫名字即開啟注釋掉即關(guān)閉例如focus-follows-mouse同名區(qū)塊大多不能重復按設備名區(qū)分的區(qū)塊如多個output除外最關(guān)鍵的性質(zhì)保存即生效。鍵綁定、輸出模式、窗口規(guī)則全部熱重載不需要重啟合成器。改亂了也不怕跑一條命令體檢niri validate它會解析配置文件并列出所有錯誤——niri 出問題時界面也會提示你執(zhí)行這條命令。最小可用配置示例其余全部走默認值layout { gaps 4 } input { focus-follows-mouse }進階定制布局、動畫、快捷鍵 列寬與窗口大小列寬不必手算。默認綁定了ModR / ModShiftR循環(huán)預設列寬Mod / Mod-以 10% 步進調(diào)節(jié)列寬ModShift / ModShift-調(diào)窗口高度。想讓某類應用常駐某一列寬用window-rule按標題或類名匹配即可。動畫怎么調(diào)所有動畫都集中在animations {}區(qū)塊每項可以獨立設成off也可以在頂部寫off一刀全關(guān)、寫slowdown統(tǒng)一減速。默認值參考窗口打開是 150ms 的ease-out-expo窗口移動、切換工作區(qū)走彈簧spring曲線。嫌慢就加animations { slowdown 0.5 // 數(shù)值小于 1 是加速 }綁定滾輪和鼠標不只是鍵盤。滾動綁定會隨natural-scroll設置自動換方向cooldown-ms可限流binds { ModWheelScrollDown cooldown-ms150 { focus-workspace-down; } ModWheelScrollUp cooldown-ms150 { focus-workspace-up; } }按下的綁定默認會重復觸發(fā)不想要就加repeatfalse。忘了某個鍵的 XKB 名字時用wev這類工具按一下就能看到。窗口規(guī)則圓角與邊框想給所有窗口加圓角加一條窗口規(guī)則即可window-rule { geometry-corner-radius 12 clip-to-geometry true }多屏、全屏與工作區(qū)每臺顯示器有獨立的窗口帶窗口絕不會溢出到相鄰屏幕拔掉顯示器它的工作區(qū)會遷移走重新接上又遷回來。全屏與最大化的效果可參考官方文檔截圖輸出配置按設備名寫區(qū)塊同一塊屏的分辨率、縮放、位置都能定死。需要接了外接屏就換一套布局這類聯(lián)動邏輯官方推薦搭配 Kanshi 工具實現(xiàn)它通過 IPC 與 niri 通信可在配置里用spawn-at-startup /usr/bin/kanshi拉起。三指手勢在gestures {}區(qū)塊配置支持觸摸板與鼠標滑動切列、切工作區(qū)。高頻問題排坑 配置報錯、界面彈黑框黑框提示的就是niri validate。按提示修到無錯誤為止binds區(qū)塊不會被自動補默認值刪掉它就等于沒有快捷鍵別誤刪。透明窗口透出色帶 / 想關(guān)掉應用自帶的圓角邊框CSD在配置頂層啟用prefer-no-csd再重啟應用niri 會請求窗口放棄自繪邊框焦點環(huán)也會改畫在窗口外圍。副作用是鼠標邊緣拖拽 resize 消失改用Mod右鍵拖動調(diào)整。NVIDIA 黑屏或顯存占用高需要較新的驅(qū)動支持 GBM并在內(nèi)核啟動參數(shù)加nvidia-drm.modeset1顯存問題按官方 Nvidia 文檔打補丁?;旌巷@卡筆記本外接屏卡頓可試debug區(qū)塊的render-drm-device指定獨顯渲染代價是更費電。要跑 Steam、舊版 Discord 等 X11 應用niri 從 25.08 起內(nèi)置 xwayland-satellite 集成按官方 Xwayland 頁啟用即可Electron 應用大多加個啟動參數(shù)就能原生跑 Wayland。登錄后有兩條狀態(tài)欄裝了桌面殼自帶一條 bar而 niri 默認配置還會spawn-at-startup waybar刪掉這行或先pkill waybar即可。鎖屏死了留下紅屏紅屏是 niri 的鎖屏背景。切到別的 TTY 向WAYLAND_DISPLAY手動拉起 swaylock或給鎖屏綁定加allow-when-lockedtrue以便在紅屏上直接再觸發(fā)。驗證與日常維護 ?養(yǎng)成兩個習慣就能省心改完配置跑一次niri validate。熱重載雖然友好但解析失敗時 niri 會彈錯誤通知并保留舊配置提前驗證更穩(wěn)。升級時先看默認配置的 diff。官方承諾發(fā)布版本之間不破壞已有配置binds除外——升級后掃一眼niri validate的輸出即可。想深入細節(jié)時從倉庫內(nèi)這兩處入手官方文檔docs/wiki 覆蓋每個配置區(qū)塊配置解析模塊 可以看到每個選項在代碼里如何生效。延伸閱讀Workspaces 頁講透工作區(qū)行為Window-Rules 頁列出全部窗口規(guī)則。【免費下載鏈接】niriA scrollable-tiling Wayland compositor.項目地址: https://gitcode.com/GitHub_Trending/ni/niri創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考