macOS更新后执行pod install遇权限拒绝及XCode加载Pods项目失败

核心解决步骤 #

1. 彻底清理Pod残留文件

   • 执行命令卸载现有Pods：

     pod deintegrate
     

   • 删除Pods目录和锁文件：

     rm -rf Pods/ Podfile.lock
     

   • 清理Xcode缓存：

     rm -rf ~/Library/Developer/Xcode/DerivedData
     

2. 修复项目目录权限

   • 将项目目录所有权赋予当前用户：

     sudo chown -R $(whoami) /Users/macbook/Desktop/work/hera/Hera-Mobile-App/
     

   • 调整目录读写权限：

     chmod -R 755 /Users/macbook/Desktop/work/hera/Hera-Mobile-App/node_modules/
     chmod -R 755 /Users/macbook/Desktop/work/hera/Hera-Mobile-App/ios/
     

3. 重新执行Pod安装（禁用root权限）

   • 进入ios目录后执行安装：

     cd /Users/macbook/Desktop/work/hera/Hera-Mobile-App/ios
     pod install
     

4. 修复Xcode加载Pods项目失败问题

   • 若之前用root执行过pod install，先删除生成的Pods项目文件：

     rm -rf ios/Pods/Pods.xcodeproj
     

   • 重复上述1-3步骤，确保所有文件归当前用户所有
   • 打开Xcode后，右键点击Pods.xcodeproj选择"Show in Finder"，检查文件所有者是否为当前用户，异常则重新执行权限修复命令

问题原因 #

• macOS更新可能重置了目录权限，导致CocoaPods无法读写React Native的Spec生成文件（如FBReactNativeSpec.h）
• 用root权限执行pod install会让Pods项目文件归root所有，Xcode以普通用户运行时无读写权限，因此无法加载Pods.xcodeproj

内容的提问来源于stack exchange，提问作者Muath Al Khatib