M1 MacBook Pro zsh环境执行pod install报zsh: abort错误解决

• Shell环境：zsh
• 设备：M1芯片MacBook Pro
• 前置状态：CocoaPods安装完成，pod init 命令可正常运行
• 异常表现：通过Xcode打开并编辑Podfile后，执行pod install 终端返回 zsh: abort pod install 报错，依赖安装流程无法完成

按优先级依次尝试，每步操作完成后重新执行pod install验证是否恢复：

• 修复arm架构下ffi依赖兼容问题
  M1芯片下旧版本CocoaPods依赖的ffi库没有原生arm64适配，会触发命令直接abort，终端执行：

  sudo arch -x86_64 gem install ffi
  

  安装完成后如果直接执行pod install仍报错，用x86转译模式执行pod命令：

  arch -x86_64 pod install
  

• 排查Podfile格式损坏问题
  Xcode编辑纯文本配置文件时，可能自动插入不可见的富文本标记、错误缩进、全角符号，导致Podfile解析崩溃。直接换纯文本编辑器（VS Code、Vim、Sublime Text均可）打开Podfile，检查以下内容：
  • target 块与对应的end关键字是否完整闭合
  • 所有符号是否为英文半角格式
  • 平台声明、pod依赖行有没有被Xcode自动补全插入多余字符
    确认格式无误后保存重试。
• 清理冲突版本与损坏缓存
  如果同时通过Homebrew、gem两种渠道安装过CocoaPods，会出现版本冲突触发abort，先执行which pod检查pod命令路径，保留其中一个安装渠道的版本，卸载另一个渠道的安装包即可。
  之后执行以下命令清理损坏的本地缓存：

  pod cache clean --all
  rm -rf Pods/
  rm -rf Podfile.lock
  pod deintegrate
  pod install
  

• 重装CocoaPods
  以上操作都无效时，完全卸载现有CocoaPods后重新安装即可：

  sudo gem uninstall cocoapods cocoapods-core cocoapods-downloader
  sudo gem install cocoapods
  pod setup
  

  如果执行gem命令提示系统目录权限不足，不要强行修改系统目录权限，改用用户目录安装：

  gem install cocoapods --user-install
  

避坑提示：日常编辑Podfile不要用Xcode打开，Xcode对非项目配置类的纯文本文件兼容性差，很容易写入不可见字符导致各类命令执行异常。

内容的提问来源于stack exchange，提问作者yunSwifty.0