You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

运行iOS端Flutter应用时执行pod install出现UTF-8编码相关报错如何解决?

问题根因

该报错是因为终端编码未设置为UTF-8,CocoaPods调用Ruby内置的Unicode归一化接口时,与ASCII-8BIT编码不兼容触发的错误。

解决步骤
  • 临时验证方案
    打开终端进入Flutter项目的ios目录,依次执行以下命令:
    export LANG=en_US.UTF-8
    pod install
    
    如执行成功则说明是编码配置问题,可按后续步骤设置永久生效。
  • 永久配置终端编码
    根据你使用的shell类型选择对应操作:
    1. 若使用zsh(MacOS 10.15 Catalina及之后版本默认shell):
      执行open ~/.zshrc打开配置文件,在末尾添加如下内容:
      export LANG=en_US.UTF-8
      export LC_ALL=en_US.UTF-8
      
      保存后执行source ~/.zshrc使配置立即生效。
    2. 若使用bash:
      执行open ~/.bash_profile打开配置文件,添加上述相同内容,保存后执行source ~/.bash_profile生效。
  • 若配置编码后仍报错,可尝试更新CocoaPods版本:
    执行命令sudo gem install cocoapods升级到最新稳定版,再重新执行pod install操作。
  • 清理项目缓存重试:
    进入项目ios目录,删除Podfile.lock文件和Pods文件夹,回到项目根目录执行flutter clean,之后重新执行flutter run部署应用即可。

报错截图1
报错截图2

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.05 15:09:01