macOS 14（Sonoma）环境下Flutter开发CocoaPods异常问题求助

看起来你遇到的是典型的Ruby环境与CocoaPods路径不匹配问题，Sonoma升级后系统默认的Shell和Ruby环境可能和你通过RVM配置的环境没有打通，导致Flutter无法识别到你安装的CocoaPods。我给你一步步排查解决的方案：

第一步：确认CocoaPods是否真的安装成功 #

先打开终端，直接输入：

pod --version

如果能输出类似1.11.3这样的版本号，说明CocoaPods本身是装好的，问题出在Flutter找不到它；如果提示command not found，那说明安装过程有问题，先重新安装CocoaPods。

如果CocoaPods已安装但Flutter识别不到： #

这种情况大概率是终端Shell没有加载RVM的环境变量，导致Flutter运行时的环境找不到你通过RVM安装的Ruby和CocoaPods。

1. 检查你的默认Shell类型 #

输入以下命令查看当前默认Shell：

echo $SHELL

如果输出是/bin/zsh（Sonoma默认是zsh），那你需要把RVM的配置加到~/.zshrc文件里；如果是/bin/bash，则加到~/.bash_profile。

2. 配置RVM环境变量到Shell配置文件 #

打开对应的配置文件，比如zsh的话：

open ~/.zshrc

在文件末尾添加以下内容（如果已经有就不用重复加）：

[[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm"

保存后关闭文件，然后重启终端，或者输入以下命令让配置生效：

source ~/.zshrc

3. 重新验证环境 #

再次输入pod --version确认能正常输出版本，然后运行：

flutter doctor

看看是否还提示CocoaPods未安装。

如果CocoaPods未安装成功： #

如果pod --version提示找不到命令，那重新执行以下步骤：

1. 先确保RVM的环境是激活的：

rvm use 2.6.6 --default

2. 重新安装CocoaPods（不用sudo，因为RVM安装的Ruby是用户级的，用sudo会用到系统Ruby，容易冲突）：

gem install cocoapods

3. 安装完成后执行pod setup初始化CocoaPods仓库（这个过程可能比较慢，耐心等待）：

pod setup

额外的排查步骤 #

1. 确认Xcode的命令行工具已安装并配置正确：

xcode-select --install

如果提示已安装，再确认Xcode许可协议已同意：

sudo xcodebuild -license accept

2. 尝试重新运行Flutter doctor时加上-v参数，查看详细日志，看看它是在哪里找CocoaPods的：

flutter doctor -v

从日志里可以看到Flutter检测CocoaPods的路径，对比你实际的pod路径（用which pod查看）是否一致。

按照这些步骤应该能解决你的问题，试试吧！

备注：内容来源于stack exchange，提问作者AlexTrejo