Flutter iOS模拟器在Android Studio运行失败但Xcode可正常构建

错误原因 #

该报错是Android Studio运行时未读取到正确的UTF-8编码环境变量导致的，Xcode默认采用系统UTF-8编码执行Pod操作，因此不会触发该错误。

解决方案 #

步骤1：修复全局终端编码配置 #

打开终端依次执行以下操作：

1. 打开Shell配置文件，如果你用的是Mac默认的zsh：
   open ~/.zshrc
   如果你用的是bash：
   open ~/.bash_profile
2. 在配置文件末尾添加以下三行配置：

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

3. 保存文件后执行命令使配置生效：
   source ~/.zshrc # bash用户替换为source ~/.bash_profile

步骤2：让Android Studio加载正确环境变量 #

完全退出Android Studio后，在终端执行以下命令启动Android Studio，使其继承终端的环境变量：
open /Applications/Android\ Studio.app

如果需要长期生效，可以在Flutter项目ios目录下的Podfile文件最顶部添加一行配置，强制指定Pod运行时的编码：
ENV['LANG'] = 'en_US.UTF-8'

步骤3：重置项目缓存（可选，上述操作无效时执行） #

依次执行以下命令清理旧缓存：

• 清理Flutter编译缓存：flutter clean
• 进入ios目录：cd ios
• 删除旧的Pods相关文件：rm -rf Pods Podfile.lock .symlinks
• 回到项目根目录拉取依赖：cd .. && flutter pub get
• 重新安装Pod依赖：cd ios && pod install

执行完成后再回到Android Studio运行项目即可。

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