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

Flutter运行故障求助:VS Code中Flutter Run/F5无法启动问题

Flutter项目无法通过flutter run或F5启动的排查方案
  • 检查设备连接权限

    • 确认手机USB调试授权:连接后务必在手机上完成授权,勾选「始终允许此计算机」选项,若授权窗口被后台遮挡,可查看手机通知栏。
    • 执行adb devices命令,确认设备状态为device;若显示unauthorized或offline,重新拔插USB,重启手机开发者模式后重试。
  • 验证Flutter环境完整性

    • 运行flutter doctor -v,重点检查Android toolchain和Connected device模块,确保无红色错误提示。若存在Android SDK缺失、licenses未同意等问题,按提示执行修复命令(如flutter doctor --android-licenses)。
  • 排查项目配置问题

    • 检查android/app/build.gradle中的minSdkVersion,确保不低于设备的Android版本(比如设备是Android 10,minSdkVersion不能设为30)。
    • 创建全新测试项目:执行flutter create test_app,切换到该项目目录后运行flutter run。若新项目能正常启动,说明原项目存在配置问题(如依赖冲突、Manifest配置错误)。
  • VS Code相关清理与更新

    • 关闭VS Code,删除项目根目录下的.dart_tool和build文件夹,重新打开项目后依次执行flutter clean和flutter run。
    • 检查Flutter、Dart扩展版本,在扩展商店完成更新后重启VS Code。
  • 查看详细报错日志

    • 执行flutter run -v,定位日志中的关键错误提示(如INSTALL_FAILED_INSUFFICIENT_STORAGE「存储空间不足」、INSTALL_FAILED_VERSION_DOWNGRADE「版本降级」),针对性解决问题。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.23 15:15:30