niri-flake输入设备配置全攻略键盘、触控板与数位板调优指南【免费下载链接】niri-flakeNix-native configuration for niri项目地址: https://gitcode.com/gh_mirrors/ni/niri-flakeniri-flake 是一款面向 niri平铺式 Wayland 合成器的 Nix 原生配置工具它为键盘、触控板、数位板等输入设备提供带构建期校验的结构化 Nix 选项让你零手写 KDL 文本即可声明式完成调优。本文将带你用最少代码快速配置出顺手、不误触、精准映射的输入体验。为什么用 niri-flake 配置输入设备✅构建期校验选项写错时nixos-rebuild直接报错并指出位置而不是运行期静默失效✅结构化选项用programs.niri.settings设置享受类型提示与自动补全✅版本同步配置 schema 始终与安装的 niri 版本保持一致升级不担心选项漂移所有选项的完整文档见docs.md选项定义在settings.nix中输入设备相关选项全部位于programs.niri.settings.input.*之下。快速上手3 步让 niri-flake 生效把仓库加为 flake 输入flake.nix{ inputs.niri-flake.url https://gitcode.com/gh_mirrors/ni/niri-flake; }导入模块并启用 niri{ imports [ inputs.niri-flake.nixosModules.niri ]; programs.niri.enable true; }执行nixos-rebuild switch完成重建。此后所有输入设备调优都通过programs.niri.settings.input声明即可。 项目入口文件为flake.nix也可git clone上文地址浏览源码与文档。键盘调优布局切换、按键重复与手感键盘对应input.keyboard是最常调优的部分programs.niri.settings.input.keyboard { xkb.layout us,ru; # 多语言布局逗号分隔 xkb.options grp:win_space_toggle,ctrl:nocaps; repeat-delay 500; # 长按多少毫秒后开始重复默认 600 repeat-rate 30; # 每秒重复字符数默认 25 track-layout window; # 按窗口记忆布局默认 global 全局共享 numlock true; # 默认开启小键盘 };要点xkb参数最终传给 libxkbcommonlayout/model/rules/variant/options各字段的取值参考xkeyboard-config(7)手册不设置时会回退读取XKB_DEFAULT_*环境变量需要完全自定义键位时把xkb.file指向一个.xkb文件其余 xkb 选项即被忽略track-layout window是效率利器每个窗口自动恢复到它上次使用的布局多语言用户强烈推荐default-config.kdl.nix中带有注释完整的键盘配置模板可对照着按需填写。触控板调优点按、自然滚动与防误触触控板对应input.touchpad高频选项速查表选项作用默认值tap轻点触控板即点击开dwt打字时禁用触控板防手掌误触关natural-scroll自然滚动方向开accel-speed指针加速度系统默认accel-profileadaptive自适应 /flat线性自适应click-methodbutton-areas边缘按键区 /clickfinger双指右击按设备drag-lock轻点拖拽后可抬指锁定再点一下才结束关disabled-on-external-mouse插入外接鼠标时自动禁用关一套开箱即用的推荐组合programs.niri.settings.input.touchpad { tap true; dwt true; natural-scroll true; accel-speed 0.2; drag-lock true; }; 进阶技巧niri 还为触控板提供了独有的scroll-factor单个数值或{ horizontal; vertical; }组合用于微调双指滚动的步进这不是 libinput 选项属于 niri 的定制能力。数位板调优屏幕映射与校准矩阵手绘数位板在input.tablet下配置programs.niri.settings.input.tablet { map-to-output eDP-1; # 数位板映射到哪块屏幕 calibration-matrix [ [ 0.0 -1.0 1.0 ] [ 1.0 0.0 0.0 ] ]; # 2×3 矩阵顺时针 90° 旋转示例 };map-to-output需要屏幕的真实名称在 niri 内运行niri msg outputs查看笔记本内屏通常叫eDP-1不设置或指定屏幕不存在时数位板会自动回退映射到已有输出之一calibration-matrix是 2×3 浮点矩阵数位板横竖屏旋转安装时靠它保证笔与屏幕坐标一致触摸屏同理input.touch.map-to-output设置映射屏幕input.touch.enable控制开关默认开启。鼠标、轨迹球与其他通用指针选项input.mouse、input.trackpoint、input.trackball与触控板共享同一组通用指针选项enable、left-handed左手模式自动交换左右键、natural-scroll、middle-emulation同时按左右键模拟中键外加滚动方法scroll-methodno-scroll/two-finger/edge/on-button-downscroll-buttonscroll-button-lock指定哪个按键触发滚动以及是否按一下锁定左手党一行搞定programs.niri.settings.input.mouse.left-handed true;常见问题速查配置不生效怎么办构建失败这是 niri-flake 构建期校验在保护你报错会指出具体选项名与类型问题照着改即可。提示 This option is not yet available in stable niri该选项仅存在于开发版将programs.niri.package设为pkgs.niri-unstable并在nixpkgs.overlays中加入inputs.niri-flake.overlays.niri。选项像是没生效检查是否设置了programs.niri.config——它会覆盖整个programs.niri.settings同时使用 Stylix 主题时切勿设置它否则主题配置全部失效。想核对最终文件programs.niri.finalConfig就是生成后的最终配置字符串可用它排查问题。延伸阅读全部选项官方文档docs.md选项定义含输入设备完整字段说明settings.nix默认配置模板内含注释掉的输入设备示例default-config.kdl.nixKDL 声明式 DSL 库kdl.nix项目简介、二进制缓存与版本说明README.md【免费下载链接】niri-flakeNix-native configuration for niri项目地址: https://gitcode.com/gh_mirrors/ni/niri-flake创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考