VS Code运行Flutter项目报错：根项目'android'中找不到'assembleDebug'任务

错误原因 #

这个报错本质是Flutter调用Android构建链路时，无法在android项目目录中找到assembleDebug构建任务，常见触发原因如下：

• 执行flutter run的终端工作目录不是Flutter项目的根目录，无法匹配到正确的android子项目
• 项目创建过程异常，android目录下缺少build.gradle、settings.gradle等核心构建配置文件
• android目录下的gradle配置被修改，比如settings.gradle中未引入app模块、Flutter gradle插件引用配置缺失
• 项目从外部拷贝/同步时文件不完整，或本地gradle缓存损坏

解决方案 #

按以下顺序排查即可解决绝大多数场景的问题：

• 确认执行命令的终端路径是Flutter项目的根目录（即直接包含lib文件夹、pubspec.yaml文件的目录），不要在父目录、android子目录或其他子路径下执行flutter run
• 检查android目录的文件完整性，若缺少核心配置文件，直接在项目根目录执行flutter create .（注意末尾的英文点号不可省略），该命令会自动补全缺失的平台配置文件，不会修改已有的业务代码
• 打开android/settings.gradle文件，确认包含include ':app'配置以及Flutter gradle插件的引用逻辑，缺失则补全对应配置：

  include ':app'
  def localPropertiesFile = new File(rootProject.projectDir, "local.properties")
  def properties = new Properties()
  assert localPropertiesFile.exists()
  localPropertiesFile.withReader("UTF-8") { reader -> properties.load(reader) }
  def flutterRoot = properties.getProperty("flutter.sdk")
  assert flutterRoot != null, "flutter.sdk not set in local.properties"
  apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"
  

• 执行缓存清理操作后重新构建：先执行flutter clean清理项目构建缓存，再执行flutter pub get重新拉取项目依赖，最后重新执行flutter run
• 若以上操作仍未解决，删除android目录下的.gradle文件夹后重新执行flutter run，工具会自动重新拉取匹配的gradle依赖完成构建

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