Flutter项目VS Code运行报错：无法解析dev.flutter.flutter-plugin-loader插件

问题情况 #

开发Flutter应用时遇到异常：项目在Android Studio中运行正常，但在VS Code启动Android版本直接构建失败，iOS版本无任何问题。已严格按照谷歌官方文档配置Gradle 8.11.1、Android Plugin 8.9、Kotlin 2.1.0，问题持续未解决。

已尝试操作 #

• 更换多个Gradle版本测试
• 重置Gradle缓存
• 检查并确认local.properties中的Flutter SDK路径正确
• 完全重置android文件夹

错误详情 #

构建失败，具体为settings.gradle.kts第19行无法解析插件[id: 'dev.flutter.flutter-plugin-loader']，同时出现无法读取/Users/MyComputerName/.gradle/caches/8.11.1/kotlin-dsl/accessors/30f9c140246fd78ff49d74be3a7b57e2/metadata.bin工作区元数据的问题。

当前settings.gradle.kts配置 #

pluginManagement {
    val flutterSdkPath = run {
        val properties = java.util.Properties()
        file("local.properties").inputStream().use { properties.load(it) }
        val flutterSdkPath = properties.getProperty("flutter.sdk")
        require(flutterSdkPath != null) { "flutter.sdk not set in local.properties" }
        flutterSdkPath
    }

    includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")

    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}

plugins {
    id("dev.flutter.flutter-plugin-loader") version "1.0.0"
    id("com.android.application") version "8.9.0" apply false
    id("org.jetbrains.kotlin.android") version "2.1.0" apply false
}

include(":app")

解决建议 #

1. 修复损坏的Gradle缓存 #

• 手动删除对应版本的Gradle缓存目录：

  rm -rf /Users/MyComputerName/.gradle/caches/8.11.1
  

• 重启VS Code后重新触发构建，让Gradle重新生成完整缓存文件

2. 对齐VS Code与Android Studio的Flutter SDK配置 #

• 打开VS Code设置（快捷键Ctrl+,），搜索Flutter SDK Path，确认路径和local.properties中的flutter.sdk完全一致
• 执行终端命令flutter doctor，检查输出中是否有SDK路径相关警告，确保环境配置正常

3. 修正插件加载逻辑 #

由于dev.flutter.flutter-plugin-loader是通过includeBuild引入的本地插件，不需要指定版本号，修改plugins块：

plugins {
    id("dev.flutter.flutter-plugin-loader")
    id("com.android.application") version "8.9.0" apply false
    id("org.jetbrains.kotlin.android") version "2.1.0" apply false
}

4. 统一VS Code的Java运行环境 #

• 确保VS Code使用的JDK和Android Studio一致（推荐使用Android Studio自带的JDK）
• 打开VS Code命令面板（Ctrl+Shift+P），执行Java: Configure Java Runtime，选择与Android Studio相同的JDK路径

5. 彻底清理项目构建文件 #

• 执行终端命令：

  flutter clean
  

• 删除android目录下的.gradle和build文件夹
• 重新执行flutter pub get后再尝试构建

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