M1 Pro 2020 Mac中Flutter Doctor检测CocoaPods安装报错求助

数据老陈

2026-8-5

解决M1 Pro Mac上CocoaPods与Ruby版本兼容及权限问题

M1 Mac自带的系统Ruby（2.6版本）属于系统保护目录，无法直接修改权限，且版本可能与CocoaPods要求不匹配；同时Homebrew安装的CocoaPods可能未优先加载，导致flutter doctor检测异常。

1. 配置Homebrew路径优先级
M1的Homebrew默认安装在/opt/homebrew，需确保其路径在系统PATH最前端，避免优先调用系统Ruby：
```
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
```
（如果使用bash，替换.zshrc为.bash_profile）
2. 清理冲突版本并重装CocoaPods
先卸载通过gem安装的CocoaPods（如果有）：
```
gem uninstall cocoapods
```
再用Homebrew重装，Homebrew会自动管理兼容的Ruby版本：
```
brew reinstall cocoapods
```
3. 验证环境配置
检查当前Ruby路径是否为Homebrew提供的版本：
```
which ruby
```
正常输出应为/opt/homebrew/bin/ruby，若不是，重新执行步骤1的路径配置。
4. 确认功能正常
检查CocoaPods版本：
```
pod --version
```
再运行flutter doctor验证：
```
flutter doctor
```