为Flutter项目添加shared_preferences后启动iOS应用报错

API 探路者

2026-8-13

解决Flutter添加shared_preferences后iOS运行的CocoaPods错误

报错信息：

警告：未安装CocoaPods，跳过pod install。
CocoaPods用于获取iOS和macOS平台侧的插件代码，以响应你在Dart侧的插件调用。
没有CocoaPods，插件无法在iOS或macOS上工作。
CocoaPods未安装或状态无效。
在iPhone 14 Pro Max上启动应用失败。

解决步骤：

安装CocoaPods
打开终端执行以下命令之一：
```
# 通过RubyGems安装
sudo gem install cocoapods
```
或使用Homebrew安装（若已安装Homebrew）：
```
brew install cocoapods
```
修复已安装但状态异常的CocoaPods
1. 进入项目的iOS子目录：
```
cd ios
```
2. 执行pod安装或更新操作：
```
pod install
# 若存在版本兼容问题，执行更新
pod update
```
3. 返回项目根目录，重新运行Flutter应用：
```
cd ..
flutter run
```
重启开发工具
若安装或修复后仍报错，重启Android Studio、VS Code或Xcode，确保工具识别到CocoaPods的安装状态。