M3芯片Mac上KMP项目Xcode构建报错：CocoaPods不在PATH中

设备：M3芯片MacBook Pro
背景：首次开发KMP项目，无Xcode使用经验；已通过brew和rbenv重装Ruby，kdoctor检测全部通过
当前环境：ruby 3.4.2、ruby gems 3.6.3、cocoa pods 1.16.2
问题：Gradle编译正常，但打开Xcode构建项目时出现错误：ERROR: CocoaPods executable not found in your PATH

Podfile代码：

# Uncomment the next line to define a global platform for your project
platform :ios, '15.4' #min ios version
target 'iosApp' do
  # Comment the next line if you don't want to use dynamic frameworks
  use_frameworks!

pod 'composeApp', :path => '../composeApp'
pod 'FirebaseStorage', '11.10.0'

end

Gradle配置代码：

cocoapods{
    summary = "Some description of Shared Module"
    homepage = "Link to Shared Module homepage"
    version = "1.0"
    ios.deploymentTarget = "15.4"
    podfile = project.file("../iosApp/Podfile")
    framework {
        baseName = "composeApp"
        isStatic = true
    }

    pod("FirebaseStorage"){linkOnly = true}

}

• 给Xcode添加CocoaPods路径映射

  1. 终端执行which pod，得到CocoaPods的绝对路径（示例：/Users/你的用户名/.rbenv/shims/pod）
  2. 打开Xcode，进入Xcode > 设置 > 位置 > 自定义路径，新增一条路径：
     • 名称填CocoaPods
     • 路径填上述命令输出的目录部分（即/Users/你的用户名/.rbenv/shims）
  3. 重启Xcode后重新构建项目

• 让Xcode加载rbenv的Shell配置

  1. 终端执行echo 'eval "$(rbenv init - zsh)"' >> ~/.zprofile（若使用bash则替换为~/.bash_profile）
  2. 关闭所有终端和Xcode窗口，重新打开Xcode再尝试构建

• 直接修改Xcode构建脚本中的Pod路径

  1. 在Xcode中打开iosApp项目，进入Build Phases找到[CP] Check Pods Manifest.lock
  2. 将脚本里的pod替换为which pod得到的绝对路径（示例：/Users/你的用户名/.rbenv/shims/pod）
  3. 保存后重新执行构建

• 验证Xcode的Shell环境

  1. 在Xcode的Build Phases中新增一个Run Script阶段
  2. 输入脚本内容：

     which pod
     ruby -v
     

  3. 运行这个阶段，查看输出的Ruby版本和Pod路径是否与终端一致。若不一致，说明Xcode未加载rbenv配置，回到第二步重新配置

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