Neovide在macOS终端启动时的窗口焦点问题分析与解决方案

问题现象

当用户在macOS系统（特别是iTerm2或Terminal.app）中通过命令行启动Neovide时，会出现两个典型问题：

1. 新窗口会在终端窗口背后打开
2. 应用图标会被排列在Command+Tab应用切换器的末尾

这个问题在通过Finder或Launchpad启动时不会出现，且与Secure Keyboard Entry设置无关。经过社区验证，该问题特定于通过.app包内二进制（如Neovide.app/Contents/MacOS/neovide）启动的场景，直接运行构建产物（如cargo build生成的二进制）则表现正常。

技术背景

macOS应用启动机制存在特殊行为：

1. 应用包与非包二进制差异：通过.app启动时会触发不同的激活策略
2. 协作式窗口激活：需要遵循NSApplication的协作激活规范
3. 安全输入上下文：终端模拟器可能保留输入焦点（但已确认不是主因）

根本原因分析

经过开发者深入排查，确定问题源于：

1. 应用签名缺失：未签名/公证的应用可能被系统限制
2. 启动时序问题：窗口创建时未正确获取激活权限
3. 打包方式差异：cargo-bundle与手动打包行为不一致

解决方案

临时解决方案

1. 延迟焦点命令（推荐）：

-- 在init.lua中添加
if vim.g.neovide then
  vim.defer_fn(function()
    vim.cmd("NeovideFocus")
  end, 25)
end

2. 通过open命令启动：

alias nv="open -n -a Neovide --args"

长期解决方案

1. 改进打包流程：

• 采用Alacritty式的Makefile打包方案
• 确保正确的Info.plist配置
• 实现应用签名和公证

2. 代码层面修复：

• 在Event::Resumed事件后初始化窗口
• 实现NSApplication的协作激活协议

技术建议

对于开发者：

1. 建议统一使用create-dmg进行打包
2. 需要处理macOS特有的激活策略
3. 应考虑实现单例模式避免多实例问题

对于用户：

1. 推荐使用官方DMG安装包
2. 可通过Alfred/Raycast等启动器间接启动
3. 关注后续版本更新获取原生修复

该问题反映了macOS平台下GUI应用与终端交互的复杂性，需要同时考虑系统安全策略和用户体验的一致性。