执行flutter run命令耗时过长且无法正常运行问题求助

问题表现 #

执行flutter run运行iOS项目时耗时极长无法启动，日志最终停在xcrun xcodebuild -list执行步骤。

引发原因 #

• Xcode命令行工具路径配置错误，xcrun无法调用到正确的Xcode开发组件
• CocoaPods本地索引缓存损坏，或者项目Pod依赖未正确安装，xcodebuild读取项目配置时阻塞
• Flutter本地编译缓存异常，导致增量编译流程卡住
• 项目Podfile存在语法错误，xcodebuild解析项目配置失败

解决方案 #

步骤1：修正Xcode命令行工具配置 #

执行以下命令查看当前配置的Xcode路径：

xcode-select -p

如果输出路径不是/Applications/Xcode.app/Contents/Developer，执行以下命令切换到正确路径：

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer

如果没有安装Xcode命令行工具，先执行安装命令：

xcode-select --install

步骤2：重新安装iOS依赖 #

进入项目ios目录：

cd ios

清理原有Pod缓存与配置文件：

rm -rf ~/Library/Caches/CocoaPods
rm -rf Pods
rm -rf Podfile.lock
rm -rf ~/Library/Developer/Xcode/DerivedData/*

重新集成Pod依赖：

pod deintegrate
pod setup
pod install

步骤3：清理Flutter缓存并重新运行 #

回到项目根目录，执行清理命令：

flutter clean
flutter pub get

重新执行运行命令即可：

flutter run

备选排查方案 #

如果以上操作后仍无法启动，手动打开ios目录下的Runner.xcworkspace文件，在Xcode中直接运行项目，根据Xcode的错误提示修复配置问题后，再返回Flutter执行run命令。

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