OmniWM多显示器设置指南：如何在多屏间高效管理窗口与焦点

【免费下载链接】OmniWMFree, open-source tiling window manager for Apple Silicon Macs, with Niri-style scrolling containers and Hyprland-style Dwindle BSP.项目地址: https://gitcode.com/gh_mirrors/om/OmniWM

OmniWM是一款专为 Apple Silicon Mac 打造的免费开源平铺窗口管理器，支持 Niri 风格滚动容器与 Hyprland 风格 Dwindle BSP 布局，并内置强大的**多显示器路由、跨屏焦点切换和鼠标跃迁（Mouse Warp）**能力。本指南将带你用不到 10 分钟完成多屏设置，让窗口和焦点在多显示器之间丝滑流动。

一、先理解：OmniWM 的两张"显示器地图" 🗺️

多屏设置的关键在于理解 OmniWM 同时使用两张各司其职的显示器地图（详见官方文档 multi-monitor.md）：

macOS 那张图不需要"长得像你桌子"，而 OmniWM 路由图则要如实还原你的桌面布局——这才是高效多屏体验的核心。

二、最快上手：四步完成多显示器设置 ⚡

OmniWM 检测到多块显示器时会自动打开设置向导；之后也可以在设置 > Monitors中点击Run Monitor Setup…重新运行。

1. 摆出 macOS "阶梯式"排列在系统设置 > 显示器 > 排列中，把物理最大（或最宽）的显示器放最下面，其余显示器依次往右上方阶梯式排列。这套排列只服务于技术性的窗口放置。

2. 绘制 OmniWM 路由图打开OmniWM 设置 > Monitors，按显示器在桌面上的真实位置摆放网格瓷砖。瓷砖之间可以隔空，但必须通过共享行或列连成一条链——只靠对角线相连的瓷砖是"断联"的，无法交换方向焦点、窗口移动和鼠标跃迁。

3. 为每块显示器分配至少一个工作区跨屏移动窗口需要"目的地工作区"，向导在某块显示器未被覆盖时不会让你完成设置。你可以把已有工作区重新指派，或为该显示器新建一个。

4. 保持 Mouse Warp 开启鼠标跃迁让指针按照 OmniWM 的"真实桌面地图"在显示器之间穿越，即使 macOS 用的是阶梯排列。这是推荐体验，默认开启。

💡 小提示：向导中的Show Numbers on Screens功能会在每块屏幕上显示数字，帮助你把物理显示器和网格瓷砖一一对应。

三、跨屏焦点与窗口移动的三个关键开关 🎯

在设置 > Monitors中，三个开关决定了焦点和窗口如何"穿越"屏幕（配置格式见 settings-reference.md 的focus一节）：

• Focus Across Monitor at Edge（focus.crossesMonitorAtEdge） 方向性焦点到达布局边缘时，继续跳到相邻路由显示器。默认关闭，适合专注单屏工作的人按需开启。

• Move Window Across Monitor at Edge（moveCrossesMonitorAtEdge） 窗口移到工作区边缘时自动被"推"到相邻显示器，且焦点始终跟随。而独立的Move Window to Left / Right / Up / Down Monitor快捷键不受此开关影响，直接把焦点窗口送到相邻显示器的当前工作区，方向上没有显示器时不会环绕。

• Follow Window to Monitor（followsWindowToMonitor） 控制普通窗口/列转移时焦点是否跟随窗口。关闭时，转移后你仍留在源工作区；边缘穿越式移动则始终跟随。

四、固定 Main / Secondary 显示器角色 🏷️

每个工作区都有"归属显示器"（Home Monitor），其默认角色是：Main为带 macOS 菜单栏的显示器，Secondary / Tertiary按排列顺序顺延——这意味着两块外接屏谁当主角由不得你。

Monitor Roles 列表（设置 > Monitors > Monitor Roles）可以彻底解决：用Add Monitor添加显示器并用箭头排序，排名最高的已连接显示器成为 Main，其次为 Secondary、Tertiary，未排名的显示器排在后面。断开的条目会保留在列表中但被跳过——例如排序DELL, LG, Built-in，在公司双外接屏时它们分别接管 Main/Secondary，拔掉外接屏后 Main 又自动交还内置屏。Quake 终端的Main Monitor选项遵循同一个 Main。

角色机制的源码可查看 MonitorRolesSection.swift。

五、工作区归属显示器：窗口移动的目的地 🏠

• 每块已连接显示器至少需要一个工作区，跨屏窗口移动才有落脚处；
• Move Workspace to Left / Right / Up / Down Monitor操作作用于当前活动工作区，它使用的是临时运行时覆盖（等价于omniwmctl workspace move-to-monitor --force）——不会改写工作区的 Home Monitor，也不会交换工作区；
• 处于不安全状态（原生全屏、隐藏应用、Scratchpad 等）时移动会被阻止，避免打断你的工作流。

对应的键盘快捷键默认值可参考官方快捷键文档 keyboard-shortcuts.md：

六、用命令行把多屏操作自动化 🔧

OmniWM 自带 CLI 工具omniwmctl，可以在脚本中执行同样的跨屏操作：

• focus-monitor next / prev / last—— 在多显示器间切换焦点；
• move-to-monitor <方向>—— 把焦点窗口移到相邻路由显示器的活动工作区；
• swap-workspace-with-monitor <方向>—— 与相邻显示器交换活动工作区；
• switch-workspace <编号>—— 切换到指定编号工作区（编号全局唯一）。

完整命令清单见 commands.md，协议细节见 IPC-CLI.md。

七、记住你的布局：家庭/办公室一键切换 🏡💼

选择Custom Arrangement后，OmniWM 会为每一组已连接显示器分别记住路由网格：

• 家里笔记本垫在外接屏下方、公司并排摆放两块屏，重新插拔即自动恢复对应网格；
• 优先匹配完全一致的已保存组合；否则继承"包含所有已连接显示器的最小已保存布局"；
• 都没有匹配时，路由回退到跟随 macOS 排列。

编辑或重置网格、完成设置向导会为"当前恰好连接的这组显示器"保存布局；而插拔显示器、打开设置这些动作永远不会意外保存布局，省去了"改坏了"的担忧。

总结：5 分钟回顾 ✅

1. macOS 阶梯排列 + OmniWM 路由图，两张地图各司其职；
2. 每块显示器至少分配一个工作区；
3. 三个开关（边缘焦点穿越 / 边缘窗口移动 / 焦点跟随）按需组合；
4. Monitor Roles 固定 Main 角色，拔掉外接屏也能优雅回退；
5. omniwmctl让一切多屏操作可脚本化。

掌握这套OmniWM 多显示器设置方法后，你的多屏桌面将从"窗口满天飞"进化为"窗口随意图而动"。🚀

【免费下载链接】OmniWMFree, open-source tiling window manager for Apple Silicon Macs, with Niri-style scrolling containers and Hyprland-style Dwindle BSP.项目地址: https://gitcode.com/gh_mirrors/om/OmniWM