You need to enable JavaScript to run this app. macOS Big Sur系统安装CocoaPods失败问题求助
优惠活动
大模型
产品
解决方案
定价
更多

macOS Big Sur系统安装CocoaPods失败问题求助

macOS Big Sur 11.0 Beta安装CocoaPods报错解决方案

问题根因

Big Sur 11.0 Beta版同时存在11.0和10.16两个版本标识,旧版Homebrew的校验逻辑未收录10.16版本,导致源码编译时版本校验失败;同时系统自带的ruby版本和Big Sur兼容性不足,会出现gem安装时原生扩展编译失败的问题。

可按优先级依次尝试以下解决方案

方案一:临时设置兼容变量绕过版本校验

  • 首先执行命令设置系统版本兼容环境变量,让工具识别为兼容的旧版本系统:
    export SYSTEM_VERSION_COMPAT=1
  • 重新执行pkg-config源码安装命令:
    brew install --build-from-source pkg-config
  • 依赖安装完成后再安装CocoaPods:
    brew install --build-from-source cocoapods

方案二:用ruby版本管理工具安装适配版本后安装CocoaPods

系统自带ruby存在权限限制和兼容性问题,用rbenv安装适配版本的ruby后再安装即可:

  • 先执行版本兼容设置:
    export SYSTEM_VERSION_COMPAT=1
  • 安装rbenv和对应ruby版本:
    brew install rbenv ruby-build
    rbenv install 2.7.5
    rbenv global 2.7.5
  • 按照rbenv的提示将初始化语句添加到终端配置文件(.zshrc或.bash_profile)后重启终端,执行命令安装CocoaPods:
    gem install cocoapods

方案三:直接使用官方预编译版本

如果前两种方案都失败,可以直接安装CocoaPods官方预编译的App版本,放到应用程序目录后执行以下命令完成配置即可:
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
pod setup

注意事项

  • 操作前需确保已经安装Xcode命令行工具,执行xcode-select --install可直接安装
  • 使用rbenv管理ruby版本时,安装CocoaPods不要加sudo前缀,避免出现权限混乱问题

内容的提问来源于stack exchange,提问作者Aliaksandr

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.14 01:24:03