如何阻止macOS应用通过终端运行可执行文件时启动多实例？

安全阿岳

2026-8-2

问题原因与解决方案

原因

LSMultipleInstancesProhibited 是macOS系统Launch Services的配置项，仅当通过双击.app包、Spotlight或open命令启动应用时，才会由系统管控单实例。直接运行Contents/MacOS下的可执行文件会绕过Launch Services，因此该配置完全不起作用。

解决办法

使用标准启动方式：放弃直接运行可执行文件，改用open命令启动应用包，例如：
```
open /Applications/YourApp.app
```
这种方式会触发Launch Services的单实例管控，即使多次执行也只会激活已有实例。

在代码中实现单实例检测：如果必须支持终端直接启动可执行文件，需要在应用代码里自行添加单实例校验逻辑：
以Swift的AppKit应用为例，在applicationDidFinishLaunching方法中加入检测：

func applicationDidFinishLaunching(_ aNotification: Notification) {
    let runningApps = NSWorkspace.shared.runningApplications
    let currentBundleID = Bundle.main.bundleIdentifier!
    // 检查是否已有同BundleID的其他实例在运行
    let existingInstance = runningApps.first { app in
        app.bundleIdentifier == currentBundleID && app != NSApplication.shared
    }
    
    if let existingInstance = existingInstance {
        // 激活已有实例并退出当前进程
        existingInstance.activate(options: .activateIgnoringOtherApps)
        NSApplication.shared.terminate(nil)
        return
    }
}

也可以用文件锁机制：启动时尝试创建一个独占锁文件（如~/Library/Application Support/YourApp/instance.lock），若创建失败则判定已有实例，直接退出并激活现有进程。