Flutter无法正常运行 Xcode构建耗时过长后失败 疑似误操作Flutter仓库导致

解决步骤 #

1. 重置Flutter SDK的本地改动 #

Flutter SDK本身通过Git管理版本，误操作提交的本地修改会直接影响SDK的正常运行，按以下操作恢复：

• 打开终端，进入你的Flutter SDK安装目录
• 执行git status查看当前仓库状态，确认是否存在非官方提交的本地改动、是否偏离了stable分支
• 执行git reset --hard origin/stable直接将本地SDK重置为官方stable分支的最新代码，所有本地误提交的改动会被清除
• 若需要固定使用你之前的2.0.0版本，执行git checkout 2.0.0即可

2. 清理项目异常缓存 #

SDK异常会导致项目生成大量无效缓存，是Xcode构建耗时极长且无报错失败的主要原因，按以下命令清理：
在你的项目根目录终端依次执行：

flutter clean
rm -rf ios/Pods ios/Podfile.lock
flutter pub get
cd ios && pod install --repo-update && cd ..

3. 重新构建运行 #

完成上述操作后，重新启动项目调试即可。首次构建会重新拉取所有依赖，耗时稍长属于正常情况，后续构建会恢复到之前的速度。

后续避坑提示 #

如果需要避免类似误操作，可以在VSCode的工作区设置中，把Flutter SDK目录加入Git忽略列表，或者使用Flutter版本管理工具统一管理SDK版本，不会因为误操作影响全局SDK。

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