yabai窗口管理器的窗口化全屏功能解析

yabai作为macOS上强大的平铺式窗口管理器，近期新增了一个实用的窗口化全屏功能(windowed-fullscreen)，这个功能为用户提供了介于原生全屏和平铺模式之间的第三种选择。

功能背景

在传统的窗口管理方案中，用户通常面临两种选择：

1. 原生全屏模式：窗口会占据整个屏幕空间，包括系统菜单栏和Dock区域，但会触发macOS的动画效果并创建一个独立的全屏空间
2. 平铺模式下的缩放全屏(zoom-fullscreen)：窗口会最大化但仍保留窗口装饰和系统界面元素

新引入的窗口化全屏功能则提供了第三种选择，它能够：

• 即时将窗口扩展到显示器的可用区域边界
• 忽略用户配置的窗口间距(gaps)和外部栏(bar)间距
• 保持窗口的常规属性而不进入macOS的特殊全屏状态

技术实现细节

从技术角度看，这个功能通过以下方式工作：

1. 空间处理：当启用窗口化全屏时，窗口会忽略所有配置的padding(包括常规padding和external_bar padding)

2. 系统界面适配：

   • 无法覆盖macOS的Notch区域或菜单栏区域(即使菜单栏设置为自动隐藏)
   • 如果Dock设置为自动隐藏，窗口可以扩展到Dock区域
   • 对于较新的MacBook，窗口顶部位置会受到Notch的限制

3. 兼容性：该功能对托管和非托管窗口都有效

使用方式

用户可以通过简单的命令启用这一功能：

yabai -m window --toggle windowed-fullscreen

与现有功能的对比

与原生全屏模式相比，窗口化全屏：

• 不会触发macOS的全屏动画
• 不会创建独立的全屏空间
• 窗口保持其原有属性

与zoom-fullscreen相比，窗口化全屏：

• 忽略所有间距配置
• 可以扩展到更接近屏幕边缘的区域
• 仍然保留窗口装饰(如标题栏)

实际应用场景

这一功能特别适合以下场景：

• 需要快速最大化窗口查看内容，但不想离开当前工作空间
• 在多显示器环境下需要保持窗口关联性
• 对系统动画效果敏感，追求即时响应的用户

注意事项

当前实现中需要注意：

1. 窗口化全屏状态下，窗口仍然可以通过鼠标拖动
2. 标题栏等窗口装饰仍然可见
3. 无法完全覆盖系统保留区域(如Notch)

yabai的这一新功能为用户提供了更灵活的窗口管理选择，填补了传统全屏和平铺模式之间的空白，使得工作流程可以更加高效和个性化。