1. 为什么我会在 Mac 上装一个平铺式窗口管理器用 Mac 做开发到今天最让我难受的从来不是编译慢也不是环境难配而是窗口管理这件事本身太手工了。你打开三个终端、一个编辑器、一个浏览器调试面板、一个日志窗口然后开始一场漫长的拖拽马拉松左边拉一下、右边对齐一下、上面留一条缝看菜单栏、下面别被程序坞挡住。好不容易摆好了来了个新窗口全乱。第二天开机位置又被打回原形。我最初的想法很简单能不能让窗口像磁贴一样自动排列我开一个它挤一个我关一个它自动补位这就是平铺式桌面的核心诉求。在 macOS 上折腾了一圈之后我最终落在了 Yabai 这个方案上——它是一个运行在系统层的窗口管理守护进程通过调用系统提供的窗口操作接口把原本需要鼠标拖拽的动作变成可编程、可脚本化的命令。这篇内容写的是我这两年把 Yabai 从装上试试用到离不开的全过程它到底在系统里做了什么事、配置文件的每个参数为什么这么写、快捷键怎么设计才不别扭、以及那些文档里不会提但能让你卡半天的坑。适合三类人看一是每天要同时盯着五六个窗口、已经被拖拽逼疯的开发者二是喜欢自己动手配环境、享受一键到位快感的效率工具爱好者三是已经装了 Yabai 但只用了默认配置、觉得好像也就那样的人——后半部分应该能让你重新认识它。提示Yabai 需要调用系统的窗口操作接口因此必须授予辅助功能权限部分增强特性还需要降低系统完整性保护等级。这意味着它不是一个零代价的工具你在动手之前要先想清楚这台机器是不是你的主力生产机。2. 拆开来看Yabai 到底在系统里做了什么理解这个东西最好的方式不是看它的命令列表而是先搞清楚它把窗口这件事抽象成了什么。这个模型想通了后面所有命令都是顺理成章的推导而不是死记硬背。2.1 三层模型显示器、空间、窗口Yabai 把整个桌面拆成三层显示器display→ 空间space→ 窗口window。显示器就是物理屏幕空间对应系统里的调度中心桌面也就是你按三指滑动切换的那些窗口则是每一个应用开的窗口。这三层是严格嵌套的一个窗口必定属于某个空间一个空间必定挂在某个显示器上。这个模型带来的第一个好处是所有操作都可以按层级下命令。你想让窗口去右边的屏幕是--display层的操作想让窗口去第 3 个桌面是--space层的操作想让窗口和邻居换位置是--window层的操作。我见过不少人卡在这一步把移动到另一个屏幕和移动到另一个桌面混着用结果窗口跑到了莫名其妙的地方。第二个好处是布局是自动维护的。当你开启平铺管理后空间里的窗口构成一棵树每个窗口是叶子节点容器是中间节点。新窗口进来时树会分裂一个节点给它窗口关闭时节点收缩兄弟节点自动占满空出来的面积。这就是自动补位的来源——它不是动画效果而是树结构重新计算的结果。2.2 BSP 布局一句话讲清它怎么切屏幕Yabai 默认的布局叫bsp全称是二叉空间分割。别被名字吓到它的逻辑就是每次切一刀第一个窗口占满全屏第二个窗口进来屏幕被竖直切一刀两个窗口各占一半第三个窗口进来在当前聚焦的那个窗口里再切一刀方向自动选较长的那条边。这个在聚焦窗口里切的细节很关键它意味着你的布局结果和你当前选中的窗口强相关。我刚开始用时总觉得布局不可预测后来才明白不是它随机是我没意识到焦点在哪。想控制结果就先用焦点命令选中目标窗口再开新窗口。除了 bsp还有两个模式值得知道布局模式行为特征适合场景我的使用频率bsp递归对半切分树形结构主工作区多终端、多编辑器对照日常 90%stack所有窗口叠满全屏仅一个可见单屏做演示、临时集中注意力偶尔切换float脱离平铺回到自由拖拽弹窗、画图工具、视频会议按应用单独指定实际用下来我的做法是全局默认bsp然后用规则引擎把聊天工具、系统设置、图形类应用单独设为float。因为这类窗口如果被强行塞进格子里尺寸会变得很别扭反而降低效率。2.3 配置即命令运行时的真实结构很多人第一次看配置文件会困惑为什么配置文件里全是yabai -m xxx这样的命令行答案在于 Yabai 的架构设计——它本身就是一个常驻的消息服务器配置文件只是一串在启动时按顺序执行的命令。这个设计带来一个非常实用的副作用配置文件里能写的你在终端里也能敲。想临时试一个参数不用改文件重启直接在终端跑yabai -m config window_gap 12就能立刻看到效果满意了再写进配置文件。我调间距的那半小时就是这么干的一边看屏幕一边敲数字从 0 试到 20最后定在 8。同样地~/.skhdrc里那堆快捷键绑定本质也是按键 → 执行一条 yabai 命令的映射表。理解了这一层你就不会把它当成两个割裂的软件而是一个整体的输入输出系统键盘是输入命令是中间层屏幕布局是输出。3. 安装与权限地基不对后面全是白费这一段我写得会比较啰嗦因为我在这上面浪费的时间最多而且大部分教程把它一笔带过了。权限这东西缺一项的表现不是报错而是部分功能静默失效特别难排查。3.1 前置检查与安装动手之前先确认三件事系统版本不要过老太老的版本对多显示器和空间的接口支持不完整装好包管理器确认你用的是有管理员权限的账户。前两项缺一样后面的命令都跑不通。安装本身很简单用包管理器两条命令搞定# 安装窗口管理主程序 brew install yabai # 安装快捷键绑定工具 brew install skhd装完先别急着配验证一下二进制是否可用yabai -v skhd -v能打印版本号就说明安装成功。如果提示命令找不到检查一下包管理器的可执行路径有没有进环境变量——这个问题在刚换机器、还没配置过终端环境的时候特别常见。3.2 三项权限缺一个就半残这是最关键的一步。Yabai 需要三类能力对应三种不同的授权方式很多人只知道第一项装完发现窗口能排列但是不能移动就是卡在第二第三项上。第一项辅助功能权限。这是最基础的没有它程序根本无法操作窗口。系统设置里找到隐私与安全性 → 辅助功能把终端程序和 yabai 二进制都加进去。注意这里要加的是实际执行的二进制文件不是它的启动脚本如果你用服务方式启动路径通常在包管理器的安装目录下。第二项屏幕录制权限。这个最容易被忽略因为名字听着跟窗口管理没关系。但 Yabai 要读取窗口的完整信息包括那些不显示在辅助功能接口里的属性必须走屏幕录制通道。没有它query类命令会返回不完整数据脚本化功能基本瘫痪。第三项脚本化附加组件scripting addition。这一项是可选但强烈建议它解锁了窗口透明度、边框、动画、阴影控制等特性。启用它需要降低系统完整性保护等级操作路径是进入恢复环境在终端里执行带参数的调整命令然后重启。注意降低系统完整性保护等级是有代价的它会削弱系统对内核和文件系统的保护。我的做法是只在个人的开发机上开启并且把系统大版本升级后重新确认状态写进自己的检查清单。如果你这台机器承担重要工作或有合规要求建议直接放弃第三项只用前两项——功能少一点但能跑得很踏实。3.3 服务托管让它开机自己跑起来手动敲命令启动是没法长期用的。正确的方式是把它注册成服务# 启动并注册为常驻服务 yabai --start-service skhd --start-service注册后程序会随登录自动拉起。这里有个细节值得单独说服务的启动顺序很重要。如果快捷键工具先于窗口管理器启动早期几个按键会打空。我自己的处理办法是在快捷键配置里给关键命令加一个极短的延迟容错或者在启动脚本里显式检查窗口管理器是否已经响应。修改配置后不用手动重启服务重新加载即可yabai --restart-service skhd --restart-service我习惯把这两条合在一起做成一个别名改完配置敲一下别名就生效比每次都去翻历史命令省事。4. 一份可以直接抄的配置文件配置文件放在用户目录下文件名固定。下面这份是我迭代了两年多的版本删掉了花哨但用不上的部分保留了真正每天在起作用的设置。4.1 全局参数间距、边框、动画# ~/.yabairc # 基础布局 yabai -m config layout bsp yabai -m config window_placement second_child yabai -m config window_origin_display default yabai -m config window_zoom on # 间距屏幕边缘留白 窗口之间留白 yabai -m config top_padding 10 yabai -m config bottom_padding 10 yabai -m config left_padding 10 yabai -m config right_padding 10 yabai -m config window_gap 8 # 边框与高亮 yabai -m config window_border on yabai -m config window_border_width 3 yabai -m config active_window_border_color 0xff4c7899 yabai -m config normal_window_border_color 0xff333333 yabai -m config window_border_radius -1 # 动画与性能 yabai -m config window_animation_duration 0.15 yabai -m config window_animation_easing ease_out_quad # 鼠标相关关掉拖拽逼自己用键盘 yabai -m config mouse_follows_focus off yabai -m config mouse_modifier fn这里面有几个参数我可以解释一下为什么是现在这个值。window_gap 8不是随便定的。屏幕边缘留白 10 像素用来避开圆角和视觉压迫窗口之间 8 像素足够让你一眼分辨边界又不会浪费太多横向空间。我试过 0完全贴合视觉上像一堵墙很难快速判断窗口分界也试过 16结果 13 寸屏幕上左右两个终端加起来少了 30 多列字符得不偿失。window_placement second_child控制新窗口插入时的位置。默认行为在某些场景下会让新窗口抢走主区域设成这个之后新窗口倾向于作为第二子节点出现主工作区的布局更稳定。window_animation_duration 0.15是我权衡后的结果。太快0会让布局变化显得突兀眼睛跟不上太慢0.3 以上在批量打开窗口时会有明显的拖沓感。0.15 秒大约是能感知到变化但不影响节奏的临界点。边框宽度 3配合颜色 0xff4c7899是我个人的偏好选中窗口用偏青的亮色标识其他窗口用深灰这样视线扫过去能立刻定位焦点。如果你经常在暗色主题和亮色主题之间切换建议把边框颜色做得中性一点。4.2 布局策略什么时候换模式全局默认用 bsp但我在快捷键里留了几个切换入口。实际使用中模式切换的价值不在于炫技而在于应对两类特殊场景。第一类是演示和讲解。需要给别人看屏幕时把空间切成stack模式所有窗口叠满全屏只在需要时切换可见的那个比一个个最小化优雅得多。第二类是临时专注。写长文档或读代码时把当前窗口撑满并让其他窗口暂时离开视线脑子里只有一个上下文效率明显不一样。# 空间层面切换布局 yabai -m space --layout bsp yabai -m space --layout stack yabai -m space --layout float注意这些命令是作用在空间上的不是全局的。这是我早期最大的误解——我以为切换一次就全变了结果发现只影响当前桌面。发现这一点之后反而觉得设计合理不同桌面可以有不同的工作性质桌面 1 做开发用 bsp桌面 2 放参考资料用 stack互不干扰。4.3 规则引擎让不该被管的窗口走开这一段是我认为整个配置里价值最高的部分。平铺管理器最烦人的地方在于它什么都要管包括那些明显不适合被塞进格子的窗口。规则引擎就是用来划边界的。# 系统设置类窗口不管 yabai -m rule --add app^系统设置$ manageoff yabai -m rule --add app^System Settings$ manageoff yabai -m rule --add title^设置$ manageoff # 文件管理器主窗口浮动 yabai -m rule --add app^Finder$ manageoff yabai -m rule --add app^Finder$ title复制 manageoff # 图形与设计类工具浮动 yabai -m rule --add app^预览$ manageoff yabai -m rule --add app^Preview$ manageoff # 聊天工具固定到指定空间并浮动 yabai -m rule --add app^Messages$ space5 yabai -m rule --add app^Messages$ manageoff # 弹窗类标题含关键词的自动浮动 yabai -m rule --add title^(打开|保存|另存为|确认|警告) manageoff规则是按顺序匹配、先命中先生效的所以顺序要讲究越具体的规则放越前面。比如先写标题含保存的浮动再写文件管理器不管否则前者会被后者覆盖。我在实际使用中还总结了一条经验别一开始就写一大堆规则。先把常用的两三个加上用一周遇到哪个窗口被管得难受了再补一条规则。这样长出来的规则表每一条都有实际意义而不是从别处抄来一堆自己都不知道在干嘛的条目。5. 快捷键设计肌肉记忆是唯一标准配置写得再漂亮如果每次操作都要想按哪个键这套系统就还没成型。快捷键设计的唯一验收标准是手比脑子快。5.1 三条设计原则第一修饰键统一。我用一个主修饰键贯穿所有窗口操作不和系统自带快捷键争抢。macOS 原生已经占用了大量组合键尤其是切换应用、切换桌面、截屏如果你的键位和它重叠会出现有时生效有时不生效的诡异现象排查起来非常痛苦。第二方向键位映射成物理方向。焦点移动用四个键位置必须和屏幕上方向一致一个居中的十字排布。我见过有人把上下左右映射成别的字母组合结果永远记不住——因为大脑里方向是空间概念键位如果不是空间排布就永远建立不起反射。第三高频操作要最短。焦点切换、窗口交换、空间切换这三个是每分钟都在做的事必须单手完成调整尺寸、旋转布局这类低频操作可以放到双层组合里。5.2 完整快捷键配置# ~/.skhdrc # 焦点切换十字键位单手可完成 alt - h : yabai -m window --focus west alt - j : yabai -m window --focus south alt - k : yabai -m window --focus north alt - l : yabai -m window --focus east # 窗口交换位置 alt shift - h : yabai -m window --swap west alt shift - j : yabai -m window --swap south alt shift - k : yabai -m window --swap north alt shift - l : yabai -m window --swap east # 窗口移动到其他空间 alt ctrl - 1 : yabai -m window --space 1 yabai -m space --focus 1 alt ctrl - 2 : yabai -m window --space 2 yabai -m space --focus 2 alt ctrl - 3 : yabai -m window --space 3 yabai -m space --focus 3 alt ctrl - 4 : yabai -m window --space 4 yabai -m space --focus 4 # 空间切换 alt - 1 : yabai -m space --focus 1 alt - 2 : yabai -m space --focus 2 alt - 3 : yabai -m space --focus 3 alt - 4 : yabai -m space --focus 4 # 窗口尺寸微调步长 50 像素 alt shift - left : yabai -m window --resize left:-50:0 alt shift - right : yabai -m window --resize right:50:0 alt shift - up : yabai -m window --resize top:0:-50 alt shift - down : yabai -m window --resize bottom:0:50 # 布局骨架调整 alt - r : yabai -m space --rotate 90 alt - m : yabai -m space --mirror y-axis alt - t : yabai -m space --toggle padding # 窗口状态切换 alt - f : yabai -m window --toggle float alt - z : yabai -m window --toggle zoom-fullscreen alt - q : yabai -m window --close # 布局模式切换 alt shift - b : yabai -m space --layout bsp alt shift - s : yabai -m space --layout stack关于尺寸微调这里有个容易被误解的地方--resize的参数格式是方向:水平变化:垂直变化但它只会影响该窗口在树中的分割比例不是绝对像素。也就是说你按一次向右扩 50实际扩大多少取决于当前窗口和兄弟窗口的相对大小。理解这一点之后就不会再纠结为什么按了五次还没到我想要的宽度——该用固定比例命令时就用比例命令。5.3 多显示器与多工作区的切换逻辑多屏场景下我建议把跨屏移动和跨空间移动彻底分开因为它们的心理模型完全不同跨屏是空间平移跨空间是层级切换。# 窗口移动到下一个显示器 alt ctrl - right : yabai -m window --display next alt ctrl - left : yabai -m window --display prev # 焦点跟随窗口跨屏 alt ctrl - down : yabai -m display --focus next我踩过的一个坑早期我把窗口移到另一块屏幕后焦点还留在原屏幕导致后续所有操作都在错误的上下文里执行越按越乱。后来统一改成移动即跟随移动完成后焦点自动过去行为就符合直觉了。另一个经验是空间数量的克制。我见过有人开十几个桌面结果自己都记不住哪个应用在哪。我的做法是固定四个1 号写代码2 号放终端和日志3 号浏览器4 号通讯与杂项。数量固定、职责固定按键和空间形成一一映射切换时不需要思考。6. 进阶玩法查询、信号与自动化配置稳定之后Yabai 真正有意思的部分才开始显现——它不只是被动响应按键还能主动感知窗口变化并触发脚本。6.1 用 query 拿到结构化信息所有query类命令返回的都是 JSON可以直接喂给其他工具处理。这是把窗口管理接入自动化流水线的入口。# 查询当前聚焦窗口的完整信息 yabai -m query --windows --window # 查询所有窗口筛出指定应用 yabai -m query --windows | jq .[] | select(.app Terminal) | .id # 查询当前空间的布局状态 yabai -m query --spaces --space配合 JSON 处理工具你可以做很多有意思的事统计自己一天在哪些应用上开了多少窗口、找出占用屏幕面积过大的窗口、在窗口数量超过阈值时自动触发整理。我自己的一个实用脚本是窗口数量警报当某个空间里窗口数超过 6 个时弹一个系统通知提醒我清理。听起来有点傻但确实有效——平铺管理的一大副作用是窗口越开越多却毫无感觉因为每个都只占一小块视觉上不刺眼但注意力已经被稀释了。6.2 信号钩子让布局自己动起来信号机制允许你在特定事件发生时执行命令。这是从手动管理跨到自动管理的关键。# 新窗口创建时如果是终端就自动放到 2 号空间 yabai -m signal --add eventwindow_created \ actionyabai -m query --windows --window | jq -e select(.app \Terminal\) yabai -m window --space 2 # 窗口获得焦点时把边框高亮部分特性需要附加组件 yabai -m signal --add eventwindow_focused \ actionecho focused: $(yabai -m query --windows --window | jq -r .title) # 空间切换时记录日志便于回溯工作节奏 yabai -m signal --add eventspace_changed \ actionecho \$(date %H:%M:%S) space changed\ ~/.yabai-space.log信号的价值在于消除重复劳动。任何你连续做过三次以上的窗口操作都应该被写成信号或者快捷键。我现在的习惯是只要发现自己又在手动把一个窗口拖到 2 号空间就立刻停下来写一条信号规则。6.3 尺寸微调的参数计算很多人卡在我想让某个窗口精确占屏幕 60%但--resize只能给相对值。解决办法是用比例命令# 让窗口占据左半边等价于比例 0.5 yabai -m window --grid 2:1:0:0:1:1 # 三列布局让当前窗口占左 2/3 yabai -m window --grid 3:1:0:0:2:1--grid的参数格式是行数:列数:起始行:起始列:跨行数:跨列数。这个命令的直观程度远高于--resize我现在的习惯是比例布局用 grid像素级微调用 resize。举个实际例子。我需要一个左侧 70% 放编辑器、右侧 30% 放终端的固定布局用 grid 就是 10 列编辑器占0:0:7:1终端占0:7:3:1。写成快捷键后一个组合键就能在几秒内还原整个工作现场比手动拖拽快一个数量级。7. 踩坑实录与问题速查下面这些全部是我真实遇到过的按排查难度从低到高排列。7.1 装完没反应按这个顺序查第一查服务真的在跑吗。用进程查询确认两个程序都在。有时候服务注册成功但进程被系统回收了表现就是完全没反应。第二查权限是不是给了正确的二进制。这是最高频错误。系统设置里加了一堆项但加的是终端而不是实际的二进制文件导致窗口能排列但无法移动。第三查配置文件有没有语法错误。配置里一条命令写错可能导致后面所有命令都不执行。排查方法是逐段注释掉二分法定位。我建议改配置时养成改三行就重启验证一次的习惯比一次改二十行然后面对一堆异常要好。第四查是不是进了全屏模式。系统原生全屏的窗口在结构上不属于普通空间平铺管理器管不到它。这不是 bug是设计边界。第五查系统完整性保护状态。如果你启用过附加组件系统升级后可能被重置。表现是边框、透明度这些特性突然消失。7.2 系统升级之后每次系统大版本更新我都做好这套环境要重配一遍的心理准备。实际情况通常没那么糟但有三件事必须重新确认附加组件是否仍然生效、辅助功能权限是否被重置、多显示器相关命令是否行为一致。我的做法是维护一个极简的恢复清单文本放在配置目录下三条命令、两个权限检查项、一个验证脚本。升级完照着跑一遍五分钟内就能确认状态不用凭记忆瞎试。7.3 常见问题速查表现象最可能的原因处理方式完全无响应服务未运行或崩溃重启服务查进程能排列但不能移动缺少辅助功能权限在系统设置中重新授权边框、透明度失效附加组件未启用或被重置确认系统完整性保护状态部分窗口不被管理规则命中manageoff检查规则顺序调整匹配条件新窗口位置异常焦点不在预期窗口上先聚焦目标窗口再开新窗多屏切换后布局错乱显示器编号变化用显示器查询命令重新确认编号快捷键有时不生效与系统快捷键冲突换修饰键组合避开系统占用重启后配置丢失配置文件路径或语法错手动启动观察输出日志窗口动画卡顿动画时长过长降到 0.1 到 0.2 之间空间切换跳错空间编号与实际不符用空间查询命令列出真实编号这张表里有一行值得单独说新窗口位置异常。这是使用初期最让人抓狂的问题因为看起来毫无规律。真实原因是 bsp 在新窗口插入时依据的是当前焦点窗口而焦点可能因为你刚才点了一下别处而发生了变化。解决办法不是改配置而是养成开新窗口前先按焦点快捷键的习惯——这个习惯建立之后布局预测准确率立刻从看运气变成基本可控。另一个我踩得最深的坑多显示器编号漂移。系统给显示器分配的编号不一定是物理顺序笔记本合盖再打开、外接屏拔插编号都可能变。如果你的快捷键里写死了移动到显示器 2某天就可能把窗口扔到不存在的地方。我的解决方案是先查一次真实编号把它写进配置注释里并且在每次改接显示器后花十秒确认一次。8. 最后说点实在的用到现在我对这类工具最大的感受是它的价值不在功能而在习惯。刚装上的第一个星期我甚至觉得效率变低了因为要重新学一套操作方式手指总是下意识去找鼠标。真正的转折点发生在某天我突然发现自己打开五个窗口后没有做过任何一次拖拽动作——那一刻才明白省下的不是几十秒操作时间而是每次切换窗口时那种又要重新摆一次的心理摩擦。如果让我给刚开始折腾的人提三条建议第一先把权限和服务这两件事彻底打牢不要跳过验证直接配快捷键第二配置从简开始只写你真正需要的十条命令用一周再逐步加第三别为了配置好看而堆砌规则每一条规则都应该能回答它解决了哪个具体让我难受的场景。还有一个我个人的小习惯每隔几个月我会把配置文件从头读一遍删掉那些写了但从来没触发过的规则和快捷键。冗余配置不只是占地方它会让你在出问题时多一层排查难度。保持配置精简比保持配置丰富要难得多也值得多。 
长河君 · 2026/10/23 1:18:48 · 阅读 1.2k macOS平铺式窗口管理实战：Yabai配置、BSP布局与快捷键设计
1. 为什么我会在 Mac 上装一个平铺式窗口管理器用 Mac 做开发到今天最让我难受的从来不是编译慢也不是环境难配而是窗口管理这件事本身太手工了。你打开三个终端、一个编辑器、一个浏览器调试面板、一个日志窗口然后开始一场漫长的拖拽马拉松左边拉一下、右边对齐一下、上面留一条缝看菜单栏、下面别被程序坞挡住。好不容易摆好了来了个新窗口全乱。第二天开机位置又被打回原形。我最初的想法很简单能不能让窗口像磁贴一样自动排列我开一个它挤一个我关一个它自动补位这就是平铺式桌面的核心诉求。在 macOS 上折腾了一圈之后我最终落在了 Yabai 这个方案上——它是一个运行在系统层的窗口管理守护进程通过调用系统提供的窗口操作接口把原本需要鼠标拖拽的动作变成可编程、可脚本化的命令。这篇内容写的是我这两年把 Yabai 从装上试试用到离不开的全过程它到底在系统里做了什么事、配置文件的每个参数为什么这么写、快捷键怎么设计才不别扭、以及那些文档里不会提但能让你卡半天的坑。适合三类人看一是每天要同时盯着五六个窗口、已经被拖拽逼疯的开发者二是喜欢自己动手配环境、享受一键到位快感的效率工具爱好者三是已经装了 Yabai 但只用了默认配置、觉得好像也就那样的人——后半部分应该能让你重新认识它。提示Yabai 需要调用系统的窗口操作接口因此必须授予辅助功能权限部分增强特性还需要降低系统完整性保护等级。这意味着它不是一个零代价的工具你在动手之前要先想清楚这台机器是不是你的主力生产机。2. 拆开来看Yabai 到底在系统里做了什么理解这个东西最好的方式不是看它的命令列表而是先搞清楚它把窗口这件事抽象成了什么。这个模型想通了后面所有命令都是顺理成章的推导而不是死记硬背。2.1 三层模型显示器、空间、窗口Yabai 把整个桌面拆成三层显示器display→ 空间space→ 窗口window。显示器就是物理屏幕空间对应系统里的调度中心桌面也就是你按三指滑动切换的那些窗口则是每一个应用开的窗口。这三层是严格嵌套的一个窗口必定属于某个空间一个空间必定挂在某个显示器上。这个模型带来的第一个好处是所有操作都可以按层级下命令。你想让窗口去右边的屏幕是--display层的操作想让窗口去第 3 个桌面是--space层的操作想让窗口和邻居换位置是--window层的操作。我见过不少人卡在这一步把移动到另一个屏幕和移动到另一个桌面混着用结果窗口跑到了莫名其妙的地方。第二个好处是布局是自动维护的。当你开启平铺管理后空间里的窗口构成一棵树每个窗口是叶子节点容器是中间节点。新窗口进来时树会分裂一个节点给它窗口关闭时节点收缩兄弟节点自动占满空出来的面积。这就是自动补位的来源——它不是动画效果而是树结构重新计算的结果。2.2 BSP 布局一句话讲清它怎么切屏幕Yabai 默认的布局叫bsp全称是二叉空间分割。别被名字吓到它的逻辑就是每次切一刀第一个窗口占满全屏第二个窗口进来屏幕被竖直切一刀两个窗口各占一半第三个窗口进来在当前聚焦的那个窗口里再切一刀方向自动选较长的那条边。这个在聚焦窗口里切的细节很关键它意味着你的布局结果和你当前选中的窗口强相关。我刚开始用时总觉得布局不可预测后来才明白不是它随机是我没意识到焦点在哪。想控制结果就先用焦点命令选中目标窗口再开新窗口。除了 bsp还有两个模式值得知道布局模式行为特征适合场景我的使用频率bsp递归对半切分树形结构主工作区多终端、多编辑器对照日常 90%stack所有窗口叠满全屏仅一个可见单屏做演示、临时集中注意力偶尔切换float脱离平铺回到自由拖拽弹窗、画图工具、视频会议按应用单独指定实际用下来我的做法是全局默认bsp然后用规则引擎把聊天工具、系统设置、图形类应用单独设为float。因为这类窗口如果被强行塞进格子里尺寸会变得很别扭反而降低效率。2.3 配置即命令运行时的真实结构很多人第一次看配置文件会困惑为什么配置文件里全是yabai -m xxx这样的命令行答案在于 Yabai 的架构设计——它本身就是一个常驻的消息服务器配置文件只是一串在启动时按顺序执行的命令。这个设计带来一个非常实用的副作用配置文件里能写的你在终端里也能敲。想临时试一个参数不用改文件重启直接在终端跑yabai -m config window_gap 12就能立刻看到效果满意了再写进配置文件。我调间距的那半小时就是这么干的一边看屏幕一边敲数字从 0 试到 20最后定在 8。同样地~/.skhdrc里那堆快捷键绑定本质也是按键 → 执行一条 yabai 命令的映射表。理解了这一层你就不会把它当成两个割裂的软件而是一个整体的输入输出系统键盘是输入命令是中间层屏幕布局是输出。3. 安装与权限地基不对后面全是白费这一段我写得会比较啰嗦因为我在这上面浪费的时间最多而且大部分教程把它一笔带过了。权限这东西缺一项的表现不是报错而是部分功能静默失效特别难排查。3.1 前置检查与安装动手之前先确认三件事系统版本不要过老太老的版本对多显示器和空间的接口支持不完整装好包管理器确认你用的是有管理员权限的账户。前两项缺一样后面的命令都跑不通。安装本身很简单用包管理器两条命令搞定# 安装窗口管理主程序 brew install yabai # 安装快捷键绑定工具 brew install skhd装完先别急着配验证一下二进制是否可用yabai -v skhd -v能打印版本号就说明安装成功。如果提示命令找不到检查一下包管理器的可执行路径有没有进环境变量——这个问题在刚换机器、还没配置过终端环境的时候特别常见。3.2 三项权限缺一个就半残这是最关键的一步。Yabai 需要三类能力对应三种不同的授权方式很多人只知道第一项装完发现窗口能排列但是不能移动就是卡在第二第三项上。第一项辅助功能权限。这是最基础的没有它程序根本无法操作窗口。系统设置里找到隐私与安全性 → 辅助功能把终端程序和 yabai 二进制都加进去。注意这里要加的是实际执行的二进制文件不是它的启动脚本如果你用服务方式启动路径通常在包管理器的安装目录下。第二项屏幕录制权限。这个最容易被忽略因为名字听着跟窗口管理没关系。但 Yabai 要读取窗口的完整信息包括那些不显示在辅助功能接口里的属性必须走屏幕录制通道。没有它query类命令会返回不完整数据脚本化功能基本瘫痪。第三项脚本化附加组件scripting addition。这一项是可选但强烈建议它解锁了窗口透明度、边框、动画、阴影控制等特性。启用它需要降低系统完整性保护等级操作路径是进入恢复环境在终端里执行带参数的调整命令然后重启。注意降低系统完整性保护等级是有代价的它会削弱系统对内核和文件系统的保护。我的做法是只在个人的开发机上开启并且把系统大版本升级后重新确认状态写进自己的检查清单。如果你这台机器承担重要工作或有合规要求建议直接放弃第三项只用前两项——功能少一点但能跑得很踏实。3.3 服务托管让它开机自己跑起来手动敲命令启动是没法长期用的。正确的方式是把它注册成服务# 启动并注册为常驻服务 yabai --start-service skhd --start-service注册后程序会随登录自动拉起。这里有个细节值得单独说服务的启动顺序很重要。如果快捷键工具先于窗口管理器启动早期几个按键会打空。我自己的处理办法是在快捷键配置里给关键命令加一个极短的延迟容错或者在启动脚本里显式检查窗口管理器是否已经响应。修改配置后不用手动重启服务重新加载即可yabai --restart-service skhd --restart-service我习惯把这两条合在一起做成一个别名改完配置敲一下别名就生效比每次都去翻历史命令省事。4. 一份可以直接抄的配置文件配置文件放在用户目录下文件名固定。下面这份是我迭代了两年多的版本删掉了花哨但用不上的部分保留了真正每天在起作用的设置。4.1 全局参数间距、边框、动画# ~/.yabairc # 基础布局 yabai -m config layout bsp yabai -m config window_placement second_child yabai -m config window_origin_display default yabai -m config window_zoom on # 间距屏幕边缘留白 窗口之间留白 yabai -m config top_padding 10 yabai -m config bottom_padding 10 yabai -m config left_padding 10 yabai -m config right_padding 10 yabai -m config window_gap 8 # 边框与高亮 yabai -m config window_border on yabai -m config window_border_width 3 yabai -m config active_window_border_color 0xff4c7899 yabai -m config normal_window_border_color 0xff333333 yabai -m config window_border_radius -1 # 动画与性能 yabai -m config window_animation_duration 0.15 yabai -m config window_animation_easing ease_out_quad # 鼠标相关关掉拖拽逼自己用键盘 yabai -m config mouse_follows_focus off yabai -m config mouse_modifier fn这里面有几个参数我可以解释一下为什么是现在这个值。window_gap 8不是随便定的。屏幕边缘留白 10 像素用来避开圆角和视觉压迫窗口之间 8 像素足够让你一眼分辨边界又不会浪费太多横向空间。我试过 0完全贴合视觉上像一堵墙很难快速判断窗口分界也试过 16结果 13 寸屏幕上左右两个终端加起来少了 30 多列字符得不偿失。window_placement second_child控制新窗口插入时的位置。默认行为在某些场景下会让新窗口抢走主区域设成这个之后新窗口倾向于作为第二子节点出现主工作区的布局更稳定。window_animation_duration 0.15是我权衡后的结果。太快0会让布局变化显得突兀眼睛跟不上太慢0.3 以上在批量打开窗口时会有明显的拖沓感。0.15 秒大约是能感知到变化但不影响节奏的临界点。边框宽度 3配合颜色 0xff4c7899是我个人的偏好选中窗口用偏青的亮色标识其他窗口用深灰这样视线扫过去能立刻定位焦点。如果你经常在暗色主题和亮色主题之间切换建议把边框颜色做得中性一点。4.2 布局策略什么时候换模式全局默认用 bsp但我在快捷键里留了几个切换入口。实际使用中模式切换的价值不在于炫技而在于应对两类特殊场景。第一类是演示和讲解。需要给别人看屏幕时把空间切成stack模式所有窗口叠满全屏只在需要时切换可见的那个比一个个最小化优雅得多。第二类是临时专注。写长文档或读代码时把当前窗口撑满并让其他窗口暂时离开视线脑子里只有一个上下文效率明显不一样。# 空间层面切换布局 yabai -m space --layout bsp yabai -m space --layout stack yabai -m space --layout float注意这些命令是作用在空间上的不是全局的。这是我早期最大的误解——我以为切换一次就全变了结果发现只影响当前桌面。发现这一点之后反而觉得设计合理不同桌面可以有不同的工作性质桌面 1 做开发用 bsp桌面 2 放参考资料用 stack互不干扰。4.3 规则引擎让不该被管的窗口走开这一段是我认为整个配置里价值最高的部分。平铺管理器最烦人的地方在于它什么都要管包括那些明显不适合被塞进格子的窗口。规则引擎就是用来划边界的。# 系统设置类窗口不管 yabai -m rule --add app^系统设置$ manageoff yabai -m rule --add app^System Settings$ manageoff yabai -m rule --add title^设置$ manageoff # 文件管理器主窗口浮动 yabai -m rule --add app^Finder$ manageoff yabai -m rule --add app^Finder$ title复制 manageoff # 图形与设计类工具浮动 yabai -m rule --add app^预览$ manageoff yabai -m rule --add app^Preview$ manageoff # 聊天工具固定到指定空间并浮动 yabai -m rule --add app^Messages$ space5 yabai -m rule --add app^Messages$ manageoff # 弹窗类标题含关键词的自动浮动 yabai -m rule --add title^(打开|保存|另存为|确认|警告) manageoff规则是按顺序匹配、先命中先生效的所以顺序要讲究越具体的规则放越前面。比如先写标题含保存的浮动再写文件管理器不管否则前者会被后者覆盖。我在实际使用中还总结了一条经验别一开始就写一大堆规则。先把常用的两三个加上用一周遇到哪个窗口被管得难受了再补一条规则。这样长出来的规则表每一条都有实际意义而不是从别处抄来一堆自己都不知道在干嘛的条目。5. 快捷键设计肌肉记忆是唯一标准配置写得再漂亮如果每次操作都要想按哪个键这套系统就还没成型。快捷键设计的唯一验收标准是手比脑子快。5.1 三条设计原则第一修饰键统一。我用一个主修饰键贯穿所有窗口操作不和系统自带快捷键争抢。macOS 原生已经占用了大量组合键尤其是切换应用、切换桌面、截屏如果你的键位和它重叠会出现有时生效有时不生效的诡异现象排查起来非常痛苦。第二方向键位映射成物理方向。焦点移动用四个键位置必须和屏幕上方向一致一个居中的十字排布。我见过有人把上下左右映射成别的字母组合结果永远记不住——因为大脑里方向是空间概念键位如果不是空间排布就永远建立不起反射。第三高频操作要最短。焦点切换、窗口交换、空间切换这三个是每分钟都在做的事必须单手完成调整尺寸、旋转布局这类低频操作可以放到双层组合里。5.2 完整快捷键配置# ~/.skhdrc # 焦点切换十字键位单手可完成 alt - h : yabai -m window --focus west alt - j : yabai -m window --focus south alt - k : yabai -m window --focus north alt - l : yabai -m window --focus east # 窗口交换位置 alt shift - h : yabai -m window --swap west alt shift - j : yabai -m window --swap south alt shift - k : yabai -m window --swap north alt shift - l : yabai -m window --swap east # 窗口移动到其他空间 alt ctrl - 1 : yabai -m window --space 1 yabai -m space --focus 1 alt ctrl - 2 : yabai -m window --space 2 yabai -m space --focus 2 alt ctrl - 3 : yabai -m window --space 3 yabai -m space --focus 3 alt ctrl - 4 : yabai -m window --space 4 yabai -m space --focus 4 # 空间切换 alt - 1 : yabai -m space --focus 1 alt - 2 : yabai -m space --focus 2 alt - 3 : yabai -m space --focus 3 alt - 4 : yabai -m space --focus 4 # 窗口尺寸微调步长 50 像素 alt shift - left : yabai -m window --resize left:-50:0 alt shift - right : yabai -m window --resize right:50:0 alt shift - up : yabai -m window --resize top:0:-50 alt shift - down : yabai -m window --resize bottom:0:50 # 布局骨架调整 alt - r : yabai -m space --rotate 90 alt - m : yabai -m space --mirror y-axis alt - t : yabai -m space --toggle padding # 窗口状态切换 alt - f : yabai -m window --toggle float alt - z : yabai -m window --toggle zoom-fullscreen alt - q : yabai -m window --close # 布局模式切换 alt shift - b : yabai -m space --layout bsp alt shift - s : yabai -m space --layout stack关于尺寸微调这里有个容易被误解的地方--resize的参数格式是方向:水平变化:垂直变化但它只会影响该窗口在树中的分割比例不是绝对像素。也就是说你按一次向右扩 50实际扩大多少取决于当前窗口和兄弟窗口的相对大小。理解这一点之后就不会再纠结为什么按了五次还没到我想要的宽度——该用固定比例命令时就用比例命令。5.3 多显示器与多工作区的切换逻辑多屏场景下我建议把跨屏移动和跨空间移动彻底分开因为它们的心理模型完全不同跨屏是空间平移跨空间是层级切换。# 窗口移动到下一个显示器 alt ctrl - right : yabai -m window --display next alt ctrl - left : yabai -m window --display prev # 焦点跟随窗口跨屏 alt ctrl - down : yabai -m display --focus next我踩过的一个坑早期我把窗口移到另一块屏幕后焦点还留在原屏幕导致后续所有操作都在错误的上下文里执行越按越乱。后来统一改成移动即跟随移动完成后焦点自动过去行为就符合直觉了。另一个经验是空间数量的克制。我见过有人开十几个桌面结果自己都记不住哪个应用在哪。我的做法是固定四个1 号写代码2 号放终端和日志3 号浏览器4 号通讯与杂项。数量固定、职责固定按键和空间形成一一映射切换时不需要思考。6. 进阶玩法查询、信号与自动化配置稳定之后Yabai 真正有意思的部分才开始显现——它不只是被动响应按键还能主动感知窗口变化并触发脚本。6.1 用 query 拿到结构化信息所有query类命令返回的都是 JSON可以直接喂给其他工具处理。这是把窗口管理接入自动化流水线的入口。# 查询当前聚焦窗口的完整信息 yabai -m query --windows --window # 查询所有窗口筛出指定应用 yabai -m query --windows | jq .[] | select(.app Terminal) | .id # 查询当前空间的布局状态 yabai -m query --spaces --space配合 JSON 处理工具你可以做很多有意思的事统计自己一天在哪些应用上开了多少窗口、找出占用屏幕面积过大的窗口、在窗口数量超过阈值时自动触发整理。我自己的一个实用脚本是窗口数量警报当某个空间里窗口数超过 6 个时弹一个系统通知提醒我清理。听起来有点傻但确实有效——平铺管理的一大副作用是窗口越开越多却毫无感觉因为每个都只占一小块视觉上不刺眼但注意力已经被稀释了。6.2 信号钩子让布局自己动起来信号机制允许你在特定事件发生时执行命令。这是从手动管理跨到自动管理的关键。# 新窗口创建时如果是终端就自动放到 2 号空间 yabai -m signal --add eventwindow_created \ actionyabai -m query --windows --window | jq -e select(.app \Terminal\) yabai -m window --space 2 # 窗口获得焦点时把边框高亮部分特性需要附加组件 yabai -m signal --add eventwindow_focused \ actionecho focused: $(yabai -m query --windows --window | jq -r .title) # 空间切换时记录日志便于回溯工作节奏 yabai -m signal --add eventspace_changed \ actionecho \$(date %H:%M:%S) space changed\ ~/.yabai-space.log信号的价值在于消除重复劳动。任何你连续做过三次以上的窗口操作都应该被写成信号或者快捷键。我现在的习惯是只要发现自己又在手动把一个窗口拖到 2 号空间就立刻停下来写一条信号规则。6.3 尺寸微调的参数计算很多人卡在我想让某个窗口精确占屏幕 60%但--resize只能给相对值。解决办法是用比例命令# 让窗口占据左半边等价于比例 0.5 yabai -m window --grid 2:1:0:0:1:1 # 三列布局让当前窗口占左 2/3 yabai -m window --grid 3:1:0:0:2:1--grid的参数格式是行数:列数:起始行:起始列:跨行数:跨列数。这个命令的直观程度远高于--resize我现在的习惯是比例布局用 grid像素级微调用 resize。举个实际例子。我需要一个左侧 70% 放编辑器、右侧 30% 放终端的固定布局用 grid 就是 10 列编辑器占0:0:7:1终端占0:7:3:1。写成快捷键后一个组合键就能在几秒内还原整个工作现场比手动拖拽快一个数量级。7. 踩坑实录与问题速查下面这些全部是我真实遇到过的按排查难度从低到高排列。7.1 装完没反应按这个顺序查第一查服务真的在跑吗。用进程查询确认两个程序都在。有时候服务注册成功但进程被系统回收了表现就是完全没反应。第二查权限是不是给了正确的二进制。这是最高频错误。系统设置里加了一堆项但加的是终端而不是实际的二进制文件导致窗口能排列但无法移动。第三查配置文件有没有语法错误。配置里一条命令写错可能导致后面所有命令都不执行。排查方法是逐段注释掉二分法定位。我建议改配置时养成改三行就重启验证一次的习惯比一次改二十行然后面对一堆异常要好。第四查是不是进了全屏模式。系统原生全屏的窗口在结构上不属于普通空间平铺管理器管不到它。这不是 bug是设计边界。第五查系统完整性保护状态。如果你启用过附加组件系统升级后可能被重置。表现是边框、透明度这些特性突然消失。7.2 系统升级之后每次系统大版本更新我都做好这套环境要重配一遍的心理准备。实际情况通常没那么糟但有三件事必须重新确认附加组件是否仍然生效、辅助功能权限是否被重置、多显示器相关命令是否行为一致。我的做法是维护一个极简的恢复清单文本放在配置目录下三条命令、两个权限检查项、一个验证脚本。升级完照着跑一遍五分钟内就能确认状态不用凭记忆瞎试。7.3 常见问题速查表现象最可能的原因处理方式完全无响应服务未运行或崩溃重启服务查进程能排列但不能移动缺少辅助功能权限在系统设置中重新授权边框、透明度失效附加组件未启用或被重置确认系统完整性保护状态部分窗口不被管理规则命中manageoff检查规则顺序调整匹配条件新窗口位置异常焦点不在预期窗口上先聚焦目标窗口再开新窗多屏切换后布局错乱显示器编号变化用显示器查询命令重新确认编号快捷键有时不生效与系统快捷键冲突换修饰键组合避开系统占用重启后配置丢失配置文件路径或语法错手动启动观察输出日志窗口动画卡顿动画时长过长降到 0.1 到 0.2 之间空间切换跳错空间编号与实际不符用空间查询命令列出真实编号这张表里有一行值得单独说新窗口位置异常。这是使用初期最让人抓狂的问题因为看起来毫无规律。真实原因是 bsp 在新窗口插入时依据的是当前焦点窗口而焦点可能因为你刚才点了一下别处而发生了变化。解决办法不是改配置而是养成开新窗口前先按焦点快捷键的习惯——这个习惯建立之后布局预测准确率立刻从看运气变成基本可控。另一个我踩得最深的坑多显示器编号漂移。系统给显示器分配的编号不一定是物理顺序笔记本合盖再打开、外接屏拔插编号都可能变。如果你的快捷键里写死了移动到显示器 2某天就可能把窗口扔到不存在的地方。我的解决方案是先查一次真实编号把它写进配置注释里并且在每次改接显示器后花十秒确认一次。8. 最后说点实在的用到现在我对这类工具最大的感受是它的价值不在功能而在习惯。刚装上的第一个星期我甚至觉得效率变低了因为要重新学一套操作方式手指总是下意识去找鼠标。真正的转折点发生在某天我突然发现自己打开五个窗口后没有做过任何一次拖拽动作——那一刻才明白省下的不是几十秒操作时间而是每次切换窗口时那种又要重新摆一次的心理摩擦。如果让我给刚开始折腾的人提三条建议第一先把权限和服务这两件事彻底打牢不要跳过验证直接配快捷键第二配置从简开始只写你真正需要的十条命令用一周再逐步加第三别为了配置好看而堆砌规则每一条规则都应该能回答它解决了哪个具体让我难受的场景。还有一个我个人的小习惯每隔几个月我会把配置文件从头读一遍删掉那些写了但从来没触发过的规则和快捷键。冗余配置不只是占地方它会让你在出问题时多一层排查难度。保持配置精简比保持配置丰富要难得多也值得多。