1. 窗口、列与工作区#

niri 的布局可以简单地想成下面这样：

1
工作区 1
2
┌──────────┬──────────┬────────────────┐
3
│ 终端     │ 编辑器   │ 浏览器         │
4
│          │          │                │
5
└──────────┴──────────┴────────────────┘
6
       列 1       列 2          列 3

默认情况下，一个新窗口会进入当前列，或者按照配置加入相邻列。一个列可以只放一个窗口，也可以放多个窗口。多个窗口进入同一列后，可以使用标签页式显示在同一个位置。

工作区则是更高一级的容器。切换工作区时，通常是在切换整组窗口；把一个列移动到另一个工作区，则只会移动当前列，不会影响其他列。

2. “焦点”和“移动”不是一回事#

这是最容易混淆的一组快捷键：

• Mod+H/J/K/L：只移动焦点，窗口位置不变；
• Mod+Ctrl+H/J/K/L：移动当前列或窗口，焦点通常仍跟随它；
• Mod+Shift+H/J/K/L：在显示器之间切换焦点；
• Mod+Ctrl+Shift+H/J/K/L：把当前列移动到另一块显示器。

可以把修饰键理解成一个层级：

1
无 Ctrl       → 看向哪里
2
加 Ctrl       → 把当前内容搬到哪里
3
加 Shift      → 针对显示器

1. 使用方向键#

2. 使用 H/J/K/L#

这里要特别注意：左右方向移动的是列，上下方向移动的是同一列中的窗口。如果当前列只有一个窗口，按 Mod+J 或 Mod+K 可能看不到明显变化，这是因为没有可切换的上下窗口。

3. 聚焦当前工作区的首列和末列#

当工作区中已经有很多列时，这两个键比连续按几十次左右方向键方便得多。

1. 左右移动列#

在 niri 中，左右移动通常以“列”为单位。假设当前列里有编辑器和终端两个窗口，使用上述快捷键时，两个窗口会作为一个整体一起移动。

2. 上下移动当前列中的窗口#

这组操作只调整当前列内部的窗口顺序。如果希望把窗口从一列移到另一列，应使用“吸收/弹出”快捷键，或者先将整个列左右移动。

3. 移动到当前工作区的首列和末列#

1. 在相邻工作区之间切换#

在默认配置中，I/U 是 PageUp/PageDown 的主键区替代方案。实际方向取决于工作区的排列方向；记忆时可以把 I 看作向上、U 看作向下。

2. 直接跳转到指定编号的工作区#

例如：

• Mod+1：回到第一个工作区；
• Mod+3：切换到第三个工作区；
• Mod+9：切换到第九个工作区。

这组快捷键非常适合把工作区固定成用途：1 号放终端，2 号放编辑器，3 号放浏览器，4 号放聊天软件。工作区是否已经创建、是否包含窗口，会受到配置和当前版本行为影响，但快捷键本身可以直接用于定位编号工作区。

3. 把当前列移动到其他工作区#

这是 niri 日常使用中非常高频的一组操作。比如正在第一个工作区编辑代码，突然发现浏览器应该放到第三个工作区，可以直接按 Mod+Ctrl+3，当前列就会被送到第 3 个工作区。

注意它移动的是当前列，不是整个工作区。如果同一列中有多个窗口，它们会一起移动；如果想移动整个工作区，应使用下面的工作区移动快捷键。

4. 移动整个工作区#

这组键和 Mod+Ctrl+PageUp/PageDown 的区别很重要：前者搬动整个工作区，后者只搬动当前列。可以用下面的方式快速区分：

1
Mod+Ctrl+方向       → 搬当前列
2
Mod+Shift+方向      → 搬整个工作区

1. 将窗口吸收到当前列#

“吸收”可以理解为把两个独立列合并。合并后，窗口会在同一列中上下排列，或者根据列的显示模式以标签页形式显示。

2. 将窗口从列中弹出#

如果当前列只有一个窗口，使用 Mod+Period 后通常会得到一个独立列；如果当前列有多个窗口，则会把当前窗口拆出去。

3. 切换标签页式显示#

当一个列中放了多个窗口时，tabbed 模式可以把它们收纳成类似浏览器标签页的界面。它适合临时把多个关联窗口放在同一个位置，例如把终端、日志和调试面板放在同一列中。

1. 切换预设列宽#

列宽是 niri 体验的核心之一。与传统平铺窗口管理器直接把屏幕切成固定区域不同，niri 允许在滚动布局中保留一个较宽的编辑器列，同时让终端和浏览器保持较窄的宽度。

2. 调整当前窗口高度#

这里的高度调整主要影响当前列中上下排列的窗口。如果上下布局看起来失衡，可以先按 Mod+Ctrl+R 恢复，再使用 Mod+Shift+Minus 或 Mod+Shift+Equal 做细调。

3. 最大化、全屏和居中#

“最大化列”和“全屏窗口”不要混为一谈：前者是布局操作，后者通常会让单个窗口进入全屏状态。退出时再次按对应快捷键即可。

4. 浮动窗口#

浮动模式适合计算器、取色器、临时对话框和需要自由拖动的窗口。niri 的设计仍然鼓励主要工作窗口保持平铺，浮动更适合处理例外场景。

1. 切换显示器焦点#

2. 把当前列移动到其他显示器#

多显示器场景中建议固定一个习惯：Shift 代表“显示器”，再加 Ctrl 代表“搬运内容”。这样不需要记住每个动作的完整名称，也不容易把“切换到另一块屏幕”和“把窗口送到另一块屏幕”混淆。

1. 截图#

截图文件的位置和命名方式由 niri 配置中的 screenshot-path 决定。例如：

1
screenshot-path "~/Pictures/Screenshots/Screenshot-%Y-%m-%d %H-%M-%S.png"

如果按下截图快捷键没有生成文件，先检查目标目录是否存在，以及配置中的路径是否有写入权限。

2. 暂时禁止快捷键拦截#

部分游戏、远程桌面、虚拟机和图形编辑软件需要自己处理 Mod、方向键或其他组合键。启用快捷键禁止后，niri 会暂时减少对键盘事件的处理，让前台程序获得更完整的输入。使用后再次按下 Mod+Escape 即可恢复。

这项功能和“窗口没有响应快捷键”不是一回事。如果只是某个快捷键配置错误，不要反复切换输入禁止状态，而应先检查 config.kdl。

1. 找到配置文件#

niri 的用户配置通常位于：

1
~/.config/niri/config.kdl

如果文件还不存在，可以先创建目录，再把系统提供的示例配置复制到用户目录：

1
mkdir -p ~/.config/niri
2
cp /etc/niri/config.kdl ~/.config/niri/config.kdl

不同发行版存放示例配置的位置可能不同，也可能只提供 default-config.kdl。找不到系统文件时，可以从 niri 官方仓库的 resources/default-config.kdl 开始。

2. 一个快捷键配置例子#

下面的配置把 Mod+Enter 改成启动 kitty，并增加一个使用 Mod+B 打开浏览器的快捷键：

1
binds {
2
    Mod+Return { spawn "kitty"; }
3
    Mod+B { spawn "firefox"; }
4
}

spawn 后面的内容不是 niri 的内置动作，而是要执行的程序名。程序不在 PATH 中时，应写绝对路径，或者改用 spawn-sh 执行 shell 命令。

3. 使用命令行触发动作#

很多 niri 动作也可以通过 IPC 调用，不必先绑定快捷键。例如：

1
niri msg action focus-column-right
2
niri msg action close-window
3
niri msg action toggle-overview

这对脚本、状态栏按钮和自动化工具很有用。可以把同一个动作同时绑定给键盘、鼠标、脚本和桌面环境组件。

4. 修改配置后如何生效#

niri 通常会在配置文件发生变化后自动重新加载。修改后可以先观察终端或日志中是否出现配置解析错误，再按 Mod+Shift+/ 检查新的快捷键是否已经显示。

如果配置无法加载，优先检查：

1. 大括号是否成对；
2. 字符串是否使用英文双引号；
3. 动作名称是否拼写正确；
4. 快捷键是否被重复定义；
5. spawn 使用的程序是否实际安装并存在于 PATH。

第一阶段：生存键#

1
Mod+Enter       打开终端
2
Mod+D           打开应用启动器
3
Mod+Shift+Q     关闭窗口
4
Mod+Shift+/     查看快捷键帮助

第二阶段：导航键#

1
Mod+H/J/K/L             移动焦点
2
Mod+Ctrl+H/J/K/L        移动列或窗口
3
Mod+1 ... Mod+9         切换工作区
4
Mod+Ctrl+1 ... Mod+Ctrl+9 发送当前列到工作区

第三阶段：布局键#

1
Mod+Comma        吸收窗口到当前列
2
Mod+Period       从当前列弹出窗口
3
Mod+R            切换预设列宽
4
Mod+F            最大化当前列
5
Mod+V            切换浮动状态
6
Mod+C            居中当前列

第四阶段：多显示器键#

1
Mod+Shift+方向             切换显示器焦点
2
Mod+Ctrl+Shift+方向        将当前列移动到另一块显示器

误区一：把 Mod+Ctrl+数字 当成切换工作区#

Mod+数字 是聚焦指定工作区；Mod+Ctrl+数字 是把当前列移动到指定工作区。两者都很常用，但结果完全不同。

误区二：以为左右移动只移动单个窗口#

niri 的水平布局以列为核心。当前列中如果有多个窗口，Mod+Ctrl+Left/Right 往往会把整列一起搬动。需要拆出单个窗口时，应先使用 Mod+Period。

误区三：把最大化和全屏当成同一个动作#

Mod+F 操作的是列布局，Mod+Shift+F 操作的是单个窗口的全屏状态。前者更适合临时扩大编辑器，后者更适合视频、演示或游戏。

误区四：认为文章中的默认键位一定适合自己的系统#

终端、应用启动器、截图工具以及音量控制命令都可能因发行版不同而不同。尤其是 Mod+Enter 和 Mod+D，它们绑定的程序只是默认示例，不代表系统一定安装了 foot 或 fuzzel。