VSCode调试Flutter应用报错求助：Android根项目找不到'app'模块及'assembleDebug'任务，Android Studio可正常运行

问题详情 #

我在VSCode中调试Flutter应用时遭遇构建失败，但相同的项目在Android Studio里却能正常启动运行。具体报错信息如下：

Launching lib\main.dart on Android SDK built for x86 in debug mode...
[!] Your app isn't using AndroidX. To avoid potential build failures, you can quickly migrate your app by following the steps on ***.
FAILURE: Build failed with an exception.
* What went wrong: Task 'assembleDebug' not found in root project 'android'.
* Try: Run gradlew tasks to get a list of available tasks. Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights.
* Get more help at ***
BUILD FAILED in 824ms
ProcessException: Process exited abnormally:
FAILURE: Build failed with an exception.
* What went wrong: Project 'app' not found in root project 'android'.
* Try: Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights.
* Get more help at ***
BUILD FAILED in 801ms
Exited (sigterm)

我已经执行flutter doctor检查开发环境，所有组件状态均正常：

Doctor summary (to see all details, run flutter doctor -v):
[√] Flutter (Channel stable, 2.5.1, on Microsoft Windows [Versión 10.0.19043.1237], locale es-EC)
[√] Android toolchain - develop for Android devices (Android SDK version 31.0.0)
[√] Chrome - develop for the web
[√] Android Studio (version 2020.3)
[√] VS Code (version 1.60.1)
[√] Connected device (3 available)
• No issues found!

可行解决建议 #

• 确认VSCode的工作目录
  这是最常见的问题根源！请确保你在VSCode中打开的是Flutter项目的根目录，而不是仅打开android子文件夹。如果VSCode的工作区只指向android目录，Gradle无法识别完整的Flutter项目结构，就会触发找不到assembleDebug任务或app项目的报错。关闭VSCode后，重新通过选择主项目文件夹打开，再尝试调试。

• 清理构建缓存
  损坏的构建缓存可能导致不同IDE之间的运行不一致，试试这些步骤：

  1. 在项目根目录执行flutter clean，清空Flutter的构建产物。
  2. 删除项目android目录下的隐藏文件夹.gradle（需要先在文件管理器中开启"显示隐藏文件"）。
  3. 执行flutter pub get重新获取所有依赖。
  4. 重启VSCode后再次尝试调试。

• 完成AndroidX迁移
  虽然Android Studio能运行应用，但VSCode提示的AndroidX问题可能间接影响构建。按以下步骤迁移到AndroidX：

  1. 打开项目的android/gradle.properties文件。
  2. 添加或确认以下两行配置存在：

     android.useAndroidX=true
     android.enableJetifier=true
     

  3. 保存文件后，执行flutter clean和flutter pub get，再尝试调试。

• 刷新VSCode中的Flutter项目
  有时VSCode的Flutter插件会出现同步问题。打开命令面板（Windows/Linux按Ctrl+Shift+P，Mac按Cmd+Shift+P），运行Flutter: Reload Flutter Project命令，强制插件重新扫描项目结构。

• 检查Gradle配置
  确认android/settings.gradle文件中包含:app模块。打开该文件，确保存在如下代码：

  include ':app'
  

  如果缺失，添加后保存文件，再尝试构建。

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