AeroSpace 项目中的 exec-on-workspace-change 回调问题解析

在 AeroSpace 窗口管理器的使用过程中，exec-on-workspace-change 回调是一个非常有用的功能，它允许用户在切换工作区时自动执行特定命令。然而，不少用户在配置这一功能时遇到了回调未被触发的问题。

问题现象

用户反馈在配置了从官方文档复制的 exec-on-workspace-change 脚本后，切换工作区时预期的 sketchybar 更新并未发生。手动执行相同的命令却能正常工作，这表明问题出在回调触发机制而非命令本身。

根本原因

经过排查，问题主要源于以下两个技术细节：

1. 路径问题：回调中使用的 sketchybar 命令未使用绝对路径，导致系统无法在默认路径下找到可执行文件
2. 环境变量传递：回调脚本需要正确处理 AeroSpace 提供的环境变量才能获得当前工作区信息

解决方案

正确的配置应该包含以下要素：

exec-on-workspace-change = ['/bin/bash', '-c',
    '/完整路径/sketchybar --trigger aerospace_workspace_change AEROSPACE_FOCUSED_WORKSPACE=$AEROSPACE_FOCUSED_WORKSPACE AEROSPACE_PREV_WORKSPACE=$AEROSPACE_PREV_WORKSPACE'
]

关键改进点包括：

• 使用 sketchybar 的完整安装路径
• 确保正确传递了 AeroSpace 提供的环境变量
• 保持 Lua 语法格式的正确性

技术深入

在 AeroSpace 中，exec-on-workspace-change 是一个强大的回调机制，它会在以下情况下触发：

1. 用户切换到新的工作区
2. 工作区布局发生变化
3. 工作区内的窗口状态改变

回调执行时，AeroSpace 会自动设置以下环境变量：

• AEROSPACE_FOCUSED_WORKSPACE：当前聚焦的工作区ID
• AEROSPACE_PREV_WORKSPACE：之前的工作区ID

最佳实践

1. 始终使用绝对路径：特别是在系统级工具调用时，避免依赖 $PATH 环境变量
2. 环境变量验证：可以先在回调中执行简单的日志记录，确认变量值是否符合预期
3. 错误处理：考虑在脚本中添加错误处理逻辑，便于问题排查
4. 性能考量：回调脚本应尽量高效，避免影响工作区切换的流畅性

通过正确理解和配置这一机制，用户可以充分发挥 AeroSpace 与 sketchybar 等状态栏工具的集成能力，实现工作区状态的实时可视化反馈。