Flutter项目构建及Xcode归档时CocoaPods编码错误求助

核心问题定位 #

错误日志明确指向终端UTF-8编码未正确配置，导致Ruby处理Unicode规范化时失败，进而引发CocoaPods执行异常；Xcode归档的沙箱不同步问题是由此衍生的连锁反应。

分步解决方案 #

1. 强制配置终端UTF-8编码 #

按照提示完成编码配置，步骤如下：

• 打开终端，编辑对应配置文件（使用zsh则编辑~/.zshrc，bash则编辑~/.bash_profile）：

  open -e ~/.zshrc
  

• 在文件末尾添加：

  export LANG=en_US.UTF-8
  export LC_ALL=en_US.UTF-8
  

• 保存后执行命令使配置生效：

  source ~/.zshrc
  

• 验证编码是否生效：

  echo $LANG
  echo $LC_ALL
  

  输出需均为en_US.UTF-8

2. 彻底清理并重建CocoaPods环境 #

完成编码配置后，清理项目的Pods环境：

• 进入Flutter项目的iOS目录：

  cd 你的项目路径/ios
  

• 执行清理命令：

  pod deintegrate
  rm -rf Podfile.lock Pods
  rm -rf Runner.xcworkspace
  

• 返回Flutter根目录执行：

  flutter clean
  flutter pub get
  

• 再次进入iOS目录安装Pods：

  cd ios
  pod install
  

3. 修复Xcode归档沙箱不同步问题 #

完成上述步骤后：

• 打开Xcode的Runner.xcworkspace（不要打开.xcodeproj文件）
• 执行Product -> Clean Build Folder（快捷键Cmd+Shift+K）
• 重新尝试归档操作

4. 额外排查项（若上述步骤无效） #

• 检查项目路径是否包含中文或非ASCII字符，CocoaPods对这类路径兼容性差，建议将项目移至纯英文路径下
• 尝试用rbenv/rvm管理Ruby版本，安装与CocoaPods 1.11.3兼容的Ruby 2.7.x版本（避免依赖系统默认Ruby）

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