如何正确安装CocoaPods及CocoaPods-generate搭建KMP开发环境？

问题根源 #

brew安装的CocoaPods使用独立的Ruby环境，和你通过gem install安装插件的Ruby环境不匹配，导致插件无法被识别；而直接用sudo gem install的CocoaPods可能因为PATH优先级问题没被kdoctor检测到。

分步解决方案 #

1. 清理现有冲突的CocoaPods安装 #

先卸载brew和gem安装的CocoaPods：

brew uninstall cocoapods
sudo gem uninstall cocoapods

如果提示有多个版本，选择全部卸载。

2. 用Ruby环境管理器统一环境（推荐） #

为避免Ruby版本和gem环境冲突，建议用rbenv管理Ruby环境：

• 安装rbenv：

  brew install rbenv
  

• 初始化rbenv并配置到shell（根据你使用的bash/zsh）：

  rbenv init
  # 按照提示将初始化命令添加到~/.zshrc或~/.bash_profile
  source ~/.zshrc # 生效配置
  

• 安装对应版本的Ruby并设置全局默认：

  rbenv install 2.7.8 # 和你当前的ruby版本匹配
  rbenv global 2.7.8
  

• 验证Ruby环境：

  ruby -v # 应显示2.7.8
  which gem # 路径应包含rbenv的目录，而非系统或brew的
  

3. 安装CocoaPods及插件 #

在统一的Ruby环境下，无需sudo，直接安装：

gem install cocoapods
gem install cocoapods-generate

• 验证安装：

  pod --version # 显示正常版本号
  pod gen --help # 能正常显示帮助说明，证明插件生效
  

4. 让kdoctor识别CocoaPods #

执行kdoctor前，确保当前shell的PATH包含rbenv的bin目录（rbenv初始化后已配置），直接运行：

kdoctor

此时应该能检测到CocoaPods和对应的generate插件。

替代方案（不使用环境管理器） #

如果不想用Ruby环境管理器，可以手动确保gem安装的CocoaPods在PATH优先级最高：

1. 卸载brew版本的CocoaPods：brew uninstall cocoapods
2. 找到gem安装的CocoaPods路径：which pod（sudo安装的路径通常是/usr/local/bin/pod）
3. 确保该路径在PATH的最前面，比如在~/.zshrc中添加：

   export PATH="/usr/local/bin:$PATH"
   

4. 重新加载shell配置：source ~/.zshrc
5. 安装插件：gem install cocoapods-generate
6. 运行kdoctor验证

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