如何解决Xcode项目中pod init执行失败的问题？

问题根源 #

你遇到的错误本质是两个核心冲突：

• Xcode 14生成的项目文件版本为56，但当前依赖的xcodeproj 1.21.0不支持该版本
• 系统Ruby 2.6.0与CocoaPods 1.11.3存在兼容性问题，触发force_encoding的FrozenError

具体解决步骤 #

1. 升级CocoaPods到兼容Xcode 14的版本 #

旧版CocoaPods 1.11.3不支持Xcode 14的项目格式，必须升级到1.12.0及以上版本：

# 卸载当前CocoaPods
sudo gem uninstall cocoapods
# 安装最新稳定版
sudo gem install cocoapods

若用Homebrew管理，执行：

brew upgrade cocoapods

2. 同步升级xcodeproj依赖库 #

升级CocoaPods后会自动匹配兼容的xcodeproj版本，若仍有异常，可手动升级：

sudo gem install xcodeproj

3. 清理CocoaPods缓存（可选） #

如果升级后问题依旧，清理缓存再尝试：

pod cache clean --all
rm -rf ~/Library/Caches/CocoaPods
rm -rf Pods
rm -rf Podfile.lock

4. 用Ruby版本管理器规避系统Ruby冲突（长期推荐） #

系统自带Ruby版本易引发兼容性问题，用rbenv管理独立Ruby环境：

# 安装rbenv
brew install rbenv
rbenv init
# 重启终端后安装兼容的Ruby版本（如3.2.2）
rbenv install 3.2.2
rbenv global 3.2.2
# 重新安装CocoaPods
gem install cocoapods

5. 手动创建Podfile（临时应急方案） #

若上述方法暂无法生效，可直接在项目根目录手动创建Podfile，示例内容：

platform :ios, '14.0'
use_frameworks!

target '你的项目名称' do
  pod 'Firebase/Core'
  # 根据需求添加其他Firebase组件，比如pod 'Firebase/Auth'
end

创建完成后执行pod install即可。

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