Flutter应用在Android Studio运行报CocoaPods编码错误如何解决
问题根因
该错误是Android Studio运行时的 shell 环境未继承系统终端的UTF-8编码配置导致:你在外部终端配置的export LANG=en_US.UTF-8仅对终端会话生效,Android Studio启动时不会加载该配置,调用pod install时触发了CocoaPods的编码不兼容错误。
解决方案
按优先级依次尝试以下操作:
方案1:全局设置系统启动编码
完全退出Android Studio后,打开终端执行以下两条命令,重启电脑后再启动AS运行项目:
launchctl setenv LANG en_US.UTF-8 launchctl setenv LC_ALL en_US.UTF-8
该配置会让所有桌面应用启动时默认继承UTF-8编码规则。
方案2:修改pod启动脚本强制指定编码
如果方案1未生效,直接修改CocoaPods的执行脚本注入编码配置:
- 终端执行
which pod获取pod的安装路径,默认路径为/usr/local/bin/pod - 用文本编辑器打开该文件,在首行
#!/usr/bin/ruby下方新增两行内容:
ENV['LANG'] = 'en_US.UTF-8' ENV['LC_ALL'] = 'en_US.UTF-8'
- 保存文件后重启Android Studio,重新运行项目即可。
方案3:更换CocoaPods版本
1.11.x版本的CocoaPods存在编码兼容的已知问题,可降级到1.10.2稳定版解决:
sudo gem uninstall cocoapods sudo gem install cocoapods -v 1.10.2
安装完成后进入项目ios目录执行pod deintegrate && pod install,再返回Android Studio运行项目。
内容的提问来源于stack exchange,提问作者nirav
相关产品推荐
相关产品推荐

