AeroSpace项目中的显示器排序问题解析

在macOS窗口管理工具AeroSpace的开发过程中，显示器排序机制引发了一些兼容性问题。本文将深入分析这一技术问题的背景、原因以及解决方案。

问题背景

AeroSpace采用了一套自定义的显示器排序算法，这套算法与macOS系统及其他流行工具（如SketchyBar）的排序方式存在差异。具体表现为：

1. AeroSpace默认按照显示器在物理空间中的位置从左到右、从上到下排序
2. 而SketchyBar等工具则将主显示器始终排在第一位，其余显示器按系统定义的顺序排列

这种差异导致用户在尝试整合不同工具时遇到兼容性问题，特别是在通过脚本自动化配置工作空间时。

技术原理分析

AeroSpace的排序实现基于NSScreen API，具体排序逻辑如下：

sorted(by: { $0.rect.minX != $1.rect.minX ? $0.rect.minX < $1.rect.minX : $0.rect.minY < $1.rect.minY })

这种排序方式确保了显示器按照物理布局的坐标位置有序排列，具有很好的可预测性。然而，macOS系统本身并未明确规定多显示器的排序标准，导致不同工具采用了不同的排序策略。

兼容性挑战

开发者面临的主要挑战包括：

1. SketchyBar使用私有API SLSCopyManagedDisplays获取显示器信息
2. macOS公开的NSScreen.screens数组虽然将主显示器放在第一位，但其余显示器的顺序未明确说明
3. NSScreenNumber返回的显示器ID既不连续也不有序

这些因素使得不同工具间的显示器ID映射变得复杂，特别是在多显示器环境下。

解决方案

AeroSpace团队最终采取了以下措施：

1. 新增了%{monitor-appkit-nsscreen-screens-id}格式化选项，输出NSScreen.screens数组中的索引
2. 保留了原有的物理位置排序作为默认行为
3. 提供了文档说明不同排序方式的区别

这种方案既保持了原有排序的稳定性，又为用户提供了与其他工具集成的可能性。用户现在可以通过格式化选项获取与NSScreen.screens一致的显示器ID，这在大多数情况下与SketchyBar使用的顺序匹配。

最佳实践建议

对于需要整合AeroSpace和其他工具的用户，建议：

1. 明确了解各工具使用的显示器排序机制
2. 使用aerospace list-monitors --format命令查看不同排序方式下的ID映射
3. 在脚本中做好ID转换处理
4. 考虑将主显示器设置在物理布局的最左侧以简化配置

总结

显示器排序问题反映了macOS多显示器环境下API设计的一些不足。AeroSpace通过提供多种排序选项，既保持了自身逻辑的一致性，又增强了与其他工具的互操作性。这一解决方案体现了良好的工程权衡，为类似兼容性问题提供了参考范例。