无法读取Runner.xcodeproj项目，Flutter运行报错求助

症状复现 #

运行Flutter项目时出现以下报错：

Launching lib/main.dart on iPhone 14 Pro Max in debug mode...
Exception: Unable to get Xcode project information:
 2023-03-24 10:21:46.452 xcodebuild[2378:22866] Error Domain=NSCocoaErrorDomain Code=3840 "Unable to parse empty data." UserInfo={NSDebugDescription=Unable to parse empty data.}
2023-03-24 10:21:46.462 xcodebuild[2378:22866] Writing error result bundle to /var/folders/w1/3p9t31q51k5c3dtmzsr5n7d00000gn/T/ResultBundle_2023-24-03_15-51-0046.xcresult
xcodebuild: error: Unable to read project 'Runner.xcodeproj'.
    Reason: The project ‘Runner’ is damaged and cannot be opened due to a parse error. Examine the project file for invalid edits or unresolved source control conflicts.

Path: /Users/tapabratthakuria/Documents/FlutterDev/Flutter_app/ios/Runner.xcodeproj
Exited

已尝试删除重新导入项目、执行flutter clean、重装Flutter，问题未解决。

解决方案 #

1. 检查并修复损坏的project.pbxproj文件 #

• 找到报错中的Runner.xcodeproj路径，右键选择「显示包内容」
• 打开project.pbxproj文件，检查是否为空、存在乱码或语法错误（比如括号不匹配、缺失分号）
  • 若文件为空：从项目备份中恢复该文件
  • 若存在语法错误：对比正常Flutter项目的project.pbxproj结构，手动修正错误部分

2. 重建iOS项目目录 #

如果修复文件无效，直接重建iOS相关文件：

• 将项目根目录下的ios文件夹重命名为ios_backup（备份原有配置）
• 在项目根目录执行命令：

  flutter create --platforms ios .
  

• 从ios_backup中手动迁移必要配置：
  • Info.plist中的权限声明、自定义配置
  • Xcode签名信息、团队配置
  • 第三方依赖的原生配置（如Podfile中的依赖、插件配置）
• 执行flutter pub get后重新运行项目

3. 清理Xcode缓存与修复权限 #

• 打开Xcode，依次执行：
  • 清理构建缓存：Cmd + Shift + K
  • 清理构建文件夹：Cmd + Option + Shift + K
• 检查项目目录权限，执行命令赋予读写权限：

  chmod -R 755 /Users/tapabratthakuria/Documents/FlutterDev/Flutter_app
  

4. 验证Flutter与Xcode版本兼容性 #

• 执行flutter doctor检查输出信息，确认Xcode版本与当前Flutter版本兼容
• 若存在版本不匹配提示，将Xcode或Flutter更新至兼容版本

内容的提问来源于stack exchange，提问作者Tapabrat Thakuria