M1芯片Mac使用CocoaPods执行pod install不生成.xcworkspace文件求助

第一步：排查Podfile格式与语法错误 #

这是最高发的原因，无报错静默跳过绝大多数是Podfile配置不符合规则：

• 确认所有依赖声明都写在对应项目target的do/end代码块内，不要写在全局区域
• 确认Podfile内声明的platform版本不低于你引入的第三方依赖要求的最低系统版本
• 确认Podfile内的target名称和你Xcode项目中的target名称完全一致，大小写也要匹配
• 最简正确Podfile示例供参考：

platform :ios, '13.0'
use_frameworks!

target '你的项目实际target名' do
  pod 'AFNetworking' # 依赖必须写在target块内
end

第二步：查看详细执行日志定位问题 #

默认pod install会静默跳过不匹配的配置项，添加verbose参数输出完整执行日志：

• 先清理项目残留配置：

  pod deintegrate
  rm -rf Pods Podfile.lock ~/Library/Caches/CocoaPods
  

• 执行带日志的安装命令：

  pod install --verbose
  

  从日志中可以直接看到依赖被跳过的具体原因，比如平台版本不匹配、target不存在等

第三步：修复开发环境适配问题 #

• 执行xcode-select -p检查命令行工具路径，若输出为/Library/Developer/CommandLineTools，执行以下命令切换为完整Xcode环境：

  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
  

• 不要使用Mac系统自带的Ruby环境，执行which ruby验证，若输出为/usr/bin/ruby，可通过rbenv/rvm安装独立Ruby版本后再重装CocoaPods
• 若你通过Homebrew安装CocoaPods，执行以下命令修复链路问题：

  brew link --overwrite cocoapods
  

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