macOS项目可正常构建运行，Xcode中SwiftUI预览启动失败求助

开发者阿泽

2026-7-20

macOS Xcode预览无法启动应用：FailedToLaunchAppError 解决方案

你的macOS项目能正常构建运行，但Xcode预览始终报错：

Cannot preview in this file
Failed to launch com.example.AppName

诊断数据显示：

FailedToLaunchAppError: Failed to launch com.example.AppName

RemoteHumanReadableError
ProcessError: FBApplicationLaunchTransaction succeeded with no process for com.example.AppName:/tmp/AppName/Build/Intermediates.noindex/Previews/AppName/Products/Debug/AppName.app

即便已经通过ProcessInfo.processInfo.environment["XCODE_RUNNING_FOR_PREVIEWS"]隔离了非预览服务，问题依然存在。可以尝试以下修复步骤：

清理构建缓存
先通过Xcode菜单栏执行Product > Clean Build Folder（快捷键⇧⌘K），若无效，手动删除预览临时目录和DerivedData：
```
rm -rf ~/Library/Developer/Xcode/DerivedData/*
rm -rf /tmp/你的项目名称/Build/Intermediates.noindex/Previews/
```
核对签名与权限配置
进入项目的Targets > 你的应用目标 > Signing & Capabilities，检查Debug预览配置下的签名身份是否和主应用一致，同时排查是否有预览环境不支持的权限（比如某些系统级Capability），临时禁用这些权限再测试预览。

确保预览View的独立性
检查预览代码是否依赖了未正确模拟的全局状态，比如数据库、网络请求等。给预览提供独立的模拟环境：

struct ContentView_Previews: PreviewProvider {
    static var previews: some View {
        ContentView()
            .environment(\.managedObjectContext, PersistenceController.preview.container.viewContext)
            // 替换为你的模拟数据/环境配置
    }
}

重置Xcode预览服务
完全退出Xcode，在终端执行以下命令重启相关服务：
```
killall -9 com.apple.CoreSimulator.CoreSimulatorService
killall -9 Xcode
```
重新打开Xcode后再尝试加载预览。
验证预处理宏配置
进入项目Build Settings，搜索Preprocessor Macros，确认Debug预览配置中已添加XCODE_RUNNING_FOR_PREVIEWS=1，保证你的环境变量判断逻辑能正常触发。