niri-flake配置入門programs.niri.settings類型化選項(xiàng)樹徹底告別KDL手寫配置【免費(fèi)下載鏈接】niri-flakeNix-native configuration for niri項(xiàng)目地址: https://gitcode.com/gh_mirrors/ni/niri-flakeniri-flake是為滾動(dòng)平鋪式 Wayland 合成器niri提供的 Nix 原生配置方案它把 niri 的 KDL 配置文件封裝成programs.niri.settings類型化選項(xiàng)樹讓你用 Nix 屬性集完成全部配置并在構(gòu)建期自動(dòng)通過niri validate校驗(yàn)——拼錯(cuò)一個(gè)參數(shù)名系統(tǒng)構(gòu)建會(huì)立刻報(bào)錯(cuò)而不是等你開機(jī)后才發(fā)現(xiàn)配置失效。本文面向新手帶你三步裝好 niri并用類型化選項(xiàng)管理鍵位、工作區(qū)和窗口規(guī)則。 它能為 niri 配置解決什么問題手寫config.kdl的三大痛點(diǎn)niri-flake 全部覆蓋手寫 KDL 的痛點(diǎn)niri-flake 的解決方案參數(shù)拼錯(cuò)無提示開機(jī)才報(bào)錯(cuò)類型化選項(xiàng)樹構(gòu)建期類型檢查配置與 niri 版本不同步構(gòu)建期用niri validate按當(dāng)前版本校驗(yàn)改配置只能重啟驗(yàn)證nix rebuild即可驗(yàn)證失敗則回滾核心能力一覽NixOS / home-manager 模塊一行enable true;裝好 niri 及全部依賴polkit、GNOME keyring、xdg portal 等programs.niri.settings類型化選項(xiàng)樹全部選項(xiàng)有類型、有默認(rèn)值、有文檔雙版本包niri-stable最新穩(wěn)定標(biāo)簽與niri-unstable開發(fā)分支最新提交并附帶二進(jìn)制緩存Stylix 集成邊框顏色、光標(biāo)主題隨主題聯(lián)動(dòng) 三步安裝從克隆到桌面第一步獲取倉庫并添加 flake 輸入git clone https://gitcode.com/gh_mirrors/ni/niri-flake在你的 NixOS 配置中聲明輸入?yún)⒖?flake.nix 查看其完整的 inputs 與 outputs 定義{ inputs.niri-flake.url github:sodiboo/niri-flake; }第二步啟用 NixOS 模塊并配置{ inputs, ... }: { imports [ inputs.niri-flake.nixosModules.niri ]; nixpkgs.overlays [ inputs.niri-flake.overlays.niri ]; programs.niri.enable true; }該模塊會(huì)自動(dòng)安裝合成器、xdg-desktop-portal-gnome截屏共享所需、啟用 polkit 與swaylock的 PAM 條目若你裝了 home-manager配置模塊會(huì)自動(dòng)導(dǎo)入無需額外操作。第三步重建系統(tǒng)sudo nixos-rebuild switch構(gòu)建成功即表示配置通過了niri validate校驗(yàn)。不想等本地編譯的話模塊默認(rèn)啟用了作者的 Cachix 二進(jìn)制緩存可用niri-flake.cache.enable false;關(guān)閉。?? programs.niri.settings 類型化選項(xiàng)上手官方文檔明確建議programs.niri.settings是配置 niri 的首選方式。選項(xiàng)樹源碼位于 settings.nix每個(gè)選項(xiàng)都帶類型和默認(rèn)值。示例 1屏幕縮放最簡入門{ programs.niri.settings { outputs.eDP-1.scale 2.0; }; }對(duì)應(yīng)的 KDLoutput eDP-1 { scale 2.0; }由 flake 自動(dòng)生成你無需再碰。示例 2鍵位綁定binds以「按鍵」為鍵名action是類型化的動(dòng)作選項(xiàng)。單參數(shù)動(dòng)作可直接寫值{ programs.niri.settings.binds { ModD.action.spawn fuzzel; Mod1.action.focus-workspace 1; }; }多參數(shù)用列表、帶命名屬性用屬性集{ programs.niri.settings.binds.XF86AudioRaiseVolume.action.spawn [ wpctl set-volume DEFAULT_AUDIO_SINK 0.1 ]; }每個(gè)鍵位還支持repeat按住連發(fā)、cooldown-ms冷卻毫秒數(shù)、allow-when-locked鎖屏下放行等子選項(xiàng)編輯器可全部自動(dòng)補(bǔ)全。選項(xiàng)樹還有哪些常用分支workspaces.name預(yù)定義工作區(qū)可指定open-on-output固定到某塊屏幕window-rules/layer-rules按應(yīng)用標(biāo)題、app-id 匹配控制窗口位置、置頂、透明度、遮擋錄屏等animations對(duì)每個(gè)事件設(shè)置 easing 或 spring 動(dòng)畫二選一的 variant 類型input.mouse/input.keyboard/input.touchpad指針加速、滾動(dòng)手法、鍵盤布局等spawn-at-startup開機(jī)自啟應(yīng)用列表完整選項(xiàng)參考含每個(gè)選項(xiàng)的類型、默認(rèn)值與說明見項(xiàng)目內(nèi)自動(dòng)生成的 docs.md它隨 niri 版本更新自動(dòng)重新生成始終與安裝版本同步。? 構(gòu)建期校驗(yàn)是如何做到的流程在 flake.nix 中你的 Nix 配置先被求值成一棵 KDL 文檔序列化邏輯在 kdl.nix隨后由niri validate -c config用你實(shí)際安裝的那個(gè) niri 包做語法與語義校驗(yàn)校驗(yàn)不通過則整個(gè)系統(tǒng)構(gòu)建失敗。也就是說選項(xiàng)拼錯(cuò) → Nix 求值階段直接報(bào)「未知選項(xiàng)」選項(xiàng)類型錯(cuò)比如 scale 寫了字符串→ 類型檢查報(bào)錯(cuò)語義上 niri 不認(rèn)的寫法 →niri validate攔截三層防線全部發(fā)生在sudo nixos-rebuild期間桌面永遠(yuǎn)只收到合法配置。 進(jìn)階何時(shí)才需要 programs.niri.configprograms.niri.config允許直接提供原始配置可傳 KDL 字符串也可傳niri.lib.kdl的結(jié)構(gòu)化節(jié)點(diǎn)。兩個(gè)注意點(diǎn)一旦設(shè)置config它會(huì)完全覆蓋programs.niri.settings生成的所有內(nèi)容想接入 Stylix 主題homeModules.stylix會(huì)寫邊框顏色與光標(biāo)主題時(shí)不要設(shè)置config否則主題選項(xiàng)無處生效調(diào)試時(shí)還可以讀取programs.niri.finalConfig——它是最終落盤配置文件的字符串形式方便核對(duì)某個(gè)選項(xiàng)的生成結(jié)果。? 新手常見問題問nixpkgs 自帶的 niri 包能用這個(gè)選項(xiàng)樹嗎類型化選項(xiàng)只保證與 flake 提供的niri-stable/niri-unstable同步若把programs.niri.package設(shè)為pkgs.niri建議改用programs.niri.config它本身版本無關(guān)且仍有構(gòu)建期校驗(yàn)。問想用 niri 開發(fā)分支怎么辦{pkgs, ...}: { nixpkgs.overlays [ inputs.niri-flake.overlays.niri ]; programs.niri.package pkgs.niri-unstable; }問裝完還缺什么建議再用 home-manager 裝上通知中心mako、狀態(tài)欄waybar記得設(shè)mainBar.layer top和啟動(dòng)器fuzzel即成完整桌面。小結(jié)niri-flake 把 niri 配置從「手寫 KDL 字符串」升級(jí)為「類型化 Nix 選項(xiàng)」programs.niri.settings提供補(bǔ)全與類型檢查構(gòu)建期niri validate兜底語義校驗(yàn)再配合niri-stable/niri-unstable雙包與二進(jìn)制緩存——這是目前用 Nix 管理 niri 配置最完整、最省心的方案。主要資料來源README.md、docs.md、settings.nix、flake.nix、kdl.nix【免費(fèi)下載鏈接】niri-flakeNix-native configuration for niri項(xiàng)目地址: https://gitcode.com/gh_mirrors/ni/niri-flake創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考